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PREFACE 


This publication describes the internal organization and logic 
of the loader. 


| OR G A N IZ ATION 


This publication contains the following: 

• "Introduction" describes the loader as a whole# including 
its relationship to the operating system. This section also 
describes the major divisions of the program and how they 
work together. 

• "Method of Operation" provides an overview of# and an 
introduction to# the logic of the loader. This section also 
contains detailed descriptions of specific operations. 

• "Organization of the Loader" describes the organization of 
the loader and the control flow within it. 

• "Microfiche Directory" directs the reader to named areas of 
code in the program listing which is contained on microfiche 
cards. 

• "Data Areas” illustrates the layout of tables and control 
blocks used by the loader. These layouts may not be 
essential for an understanding of the program's logic# but 
they are essential for analysis of storage dumps. 

• "Diagnostic Aids" includes the general register contents at 
entry points to program components# definitions of the 
internal error codes# and a list of service aids available 
with the loader. 

• "Appendix. Error Messages# Etc." contains a list of error 
messages and the routines and CSECTs they originate in. 

This section also contains a list of loader input 
conventions and restrictions# and detailed descriptions of 
input record formats. 

• "List of Terms and Abbreviations” lists the terms and 
abbreviations used in this book# and what they mean. 

An index is also included. 


PRERE_qUI_SJT E KNOWLEDGE 

To use this book effectively# you should be familiar with the 
following topics: 

• Assembler language functions and specifications under OS/VS 

• How to analyze a main storage dump from MVS/370 

• General concepts of the linkage editor and loader 
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REQUIRED PUBLICATIONS 

• MVS/370 linkage.Editor, and Loader User'sOuide , GC26-4061, 
for a description of the linkage editor and loader 

• OS/VS ~ DOS/VSE ~ VM/370 Assembler language , GC33-4010, for 
a description of assembler language functions 

• 0S/VS2 Sys tem Programming Library.! Debugging Handbook, 
GC28-1047 through GC28-1049, for details on how to analyze a 
main storage dump 




Hithin the text, references are made to the publications listed 
in the table below. 


Short Title 

Publication Title 

Order 

Number 

Assembler 

Language 

OS/VS - DOS/VSE - VM/370 

GC33-4010 

Assembler Language 

Debugging 

Handbook 

0S/VS2 System Programming 
Libraryt Debugging 

Handbook* Volumes 1 throuah 

GC28-1047 

GC28-1048 

GC28-1049 

JCL 

MVS 4£1 

GC28-1300 

Linkage Editor 
and Loader 

MVS/370 Linkage'Editor and 
Loader User*s Guide 

GC26-4061 

Supervisor 
Services and 
Macros 

0S/VS2 Supervisor Services 
and Macros 

GC28-1H4 
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SUMMARY OF AMENDMENTS 


| RELEASE 1.1 LIBRARY UPPATE, DECEMBER 1985 
| SERVICE CHANGES 


All MVS/370 titles referred to in this publication have been 
changed to their corresponding MVS/XA titles. Order numbers of 
the MVS/370 books remain the same. 

Information has been added to reflect technical service changes. 
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This section provides a general description of the loader. 
Included are the purpose and functions of the program, its 
physical and environmental characteristics, and operational 
considerations necessary for its use. Also discussed in this 
section is the generalized theory of loading. 


BJRPflSS 


The purpose of the loader is to combine input object and load 
modules into an executable program in virtual storage. In this 
regard, the loader performs the basic functions of the linkage 
editor and program fetch to obtain high-performance loading. 

(The loader can be used only when special linkage editor 
processing, such as overlaying modules, is not required.) 

Use of the loader can provide advantages of increased system 
throughput and conservation of auxiliary storage space. System 
throughput can be increased through: 

• Elimination of scheduler overhead, since loading and 
execution occur in a single job step 

• Elimination of linkage editor I/O for intermediate and final 
output 

• Elimination of certain linkage editor functions such as 
control statement processing and overlay structuring 

• Reduction of time required to read input through improved 
buffering techniques 

• Reduction of time required for library search through use of 
link pack resident modules 

• Elimination of time required to read input from an external 
device through use of an internal input data area prepared 
by a compiler 

Auxiliary storage space is conserved through: 

• Deferring inclusion of processor library routines until load 
time, thus reducing space required for the program. (This 
applies to a production environment in which jobs are 
selected from a job library.) 

• Eliminating space needed for the linkage editor intermediate 
and output data sets. 


F MK IMN 3 


The loader performs the basic logical functions of the linkage 
editor and of program fetch. Like the linkage editor, the 
loader combines and links the input modules. In addition, the 
loader assigns actual machine addresses to the resulting program 
and then passes control directly to the program for execution. 

In this regard, the loader functions as program fetch does. 

As part of the link-loading procedure, the loader also 
automatically deletes duplicate copies of a module, and can 
include modules from a system library. 
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Loader operation requires about 21K bytes of virtual storage. 1 
(This amount does not include the storage for the loaded program 
and the condensed symbol table.) The storage for loader 
operation includes that for loader code (about 14K bytes)# for 
the data management access methods (about 6K bytes)# and for 
loader buffers and tables (about 3K bytes). If the access 
methods are resident# and if the loader code is resident in the 
link pack area# part of the loader storage may be allocated from 
system storage. 

Figure 1 shows an example of loader structure in virtual 
storage. 


Loader Con- X 
trol GETMAINU 


Loader I 

Processor % 
GETMAIN 


High 

Address 

Register save area for LOAD of Loader (72 bytes) 


LOADER (Processing) 

I 

TABLES (Dynamic) 


Loaded Program 

_ 1 _ 

Descriptive information about loaded program 

LOADER (CONTROL) 


OPERATING SYSTEM 
CONTROL PROGRAM 

Low 

Address 


> 






> 


Freed after pro¬ 
gram execution 


Freed before pro¬ 
gram execution 


Freed after pro¬ 
gram execution 


Figure 1. Loader Storage Layout 


The actual amount required depends on the type of input (for 
example, input produced by the PL/1 compiler requires a 
minimum of 10K bytes for loader tables). 
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The loader can be used in batch mode, or it can also be invoked 
under the time sharing option (TSO). 

It can be used in one of three ways: 

1. As a job step, when the loader is specified on an EXEC job 
control statement in the input stream; 

2. As a subprogram, via the execution of a LOAD macro 
instruction, a LINK macro instruction, or an XCTL macro 
instruction; 

3. As a subtask, in multitasking systems, via execution of an 
ATTACH macro instruction. 

Loader operation requires access to a primary input source, the 
SYSLIB data set . Input may be from a card reader, magnetic 
tape, or a direct access device, or it may be a concatenation of 
data sets from different types of devices. Input may also be an 
internal input data area prepared by a compiler. 

An automatic search of a system library can occur to complete 
the input. This requires use of the SYSLIB data set . It is 
defined only as a partitioned data set. SYSLIB may also be 
concatenated; however, SYSLIB input consists of object modules 
only, or load modules only. 

When the link pack area is available, the loader can include in 
the loaded program resident modules listed in the contents 
directory entry queue. 

The loader uses the SYSLOUT data set for both diagnostic 
messages and module maps, and the SYSTERM data set for 
diagnostic messages only. These data sets may be used in 
conjunction with each other or separately. 


PHYSICAL CHARACTERISTICS 

The loader consists of a control portion and a processing 
portion. The control portion handles linkages to and from the 
processing portion, which performs the actual program loading, 
and to and from the loaded program for its execution. The 
relationship between the portions of the loader is illustrated 
in Figure 2 on page 4. 

The loader consists of two loads: the first is module HEHLCTRL, 
the control portion; and the other comprises control sections 
HEMLDDEF, HEWLIOCA, HEHLRELO, HEWLIDEN, and HENLLIBR, which 
together perform program loading. Because of the 
interrelationships among module functions, the loader is not a 
candidate for overlay structuring. 


gBMMB 

Loader operation depends on the type of input received and on 
user options that may be specified. 

The input to the loader may be load modules produced by the 
linkage editor, and/or object modules produced by the following 
language processors: ALGOL, COBOL, FORTRAN, PL/I, RPG, and 
Assembler. 2 Input may be from an external device, or it may be 
one or more internal object modules; that is, a data area that 
resides in virtual storage and consists of contiguous object 
module records. If input is an internal data area, the object 
module records containing the instructions and data of the 


If the input consists only of load modules, the user must 
specify the loaded program v s entry point. 
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HEWLOADR 



Figure 2. Loader Control Logic Flow 


program (text) can be omitted from the data area itself and 
replaced by passing a pointer to the text. The loader then 
perforins its usual functions of relocation and linkage on the 
text without having to read or move it. 

If the loader is processing an internal data area, input from an 
external device cannot be concatenated to it. 


INPUT MODULE STRUCTURE 

Object modules and load modules have basically the same logical 
structure (see Figure 3 on page 5). Each consists of> 

• Control dictionaries, containing the information necessary 
to resolve symbolic cross-references between control 
sections of different modules. 

• Text, containing the instructions and data of the program. 
If an internal object module is being processed, text 
prepared by a compiler may be omitted and replaced by a 
pointer to its location. 

• End-of-module indication (END statement in object modules; 
EOM indicator in load modules). 
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Lirtkogc Editor Input 


Linkage Editor Output 


Object Module Load Module 



The instructions and data of any module may contain symbolic 
references to specific areas of code. The symbols may be 
defined and referred to in the same module, or may be defined in 
one module and referred to in another. Thus, symbolic 
references are either internal or external with respect to the 
module in which they occur. A symbol that refers to external 
code is called an external reference (ER). External and 
internal references are made through address constants. 

The loader performs its function of changing all address 
constants to actual machine addresses by manipulating the input 
modules' control dictionaries. 

Object modules usually contain two control dictionaries! an 
external symbol dictionary (ESD) and a relocation dictionary 
(RLD). If the module contains no relocatable address constants, 
an RLD is not present. 

Load modules are a composite of object modules, and, therefore, 
contain a composite ESD (CESD). Load modules contain RLDs also, 
unless there are no relocatable address constants. General 
descriptions of the control dictionaries follow. For detailed 
descriptions, see the Appendix. 
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External Symbol Dictionary (ESD) 

The external symbol dictionary contains entries for all external 
symbols defined or referred to within a module. Each entry 
indicates the symbol and its type and gives its position, if 
any, within the module. For example, there is an ESD entry for 
each control section, entry point, common area, and external 
dummy section. (An external dummy section defines a 
displacement within an area, obtained during execution of the 
input program via a GETMAIN macro instruction. External DSECTs 
are also referred to as pseudo registers.) 


Relocation Dictionary (RLD) 

The relocation dictionary (RLD) contains at least one entry for 
every relocatable address constant (thus, for every external and 
internal reference) in a module. An RLD entry identifies an 
address constant by indicating both its location within a 
control section, and the external symbol (in the ESD) whose 
value determines the value of the address constant. 


INTERRELATIONSHIP OF CONTROL DZCTZONARZES 

The control dictionaries and associated text are related through 
a system of numbers known as ESD identifiers (ESD IDs). An ESD 
ID is assigned to each external symbol according to its 
sequential appearance in an object module. The external symbol 
dictionary entries, as created by a compiler or an assembler, 
have the same sequential order, so the ESD ID gives the 
dictionary entry number of an external symbol. 3 (The linkage 
editor renumbers the ESD IDs to maintain the ordered 
relationship when combining modules into a load module.) 

Although the ESD IDs do not appear in the ESD entries, they are 
used in label definitions, text items, and RLD entries to refer 
to the symbols in the ESD. 

In the RLD entries, the ESD IDs are used to show two 
relationships between the RLD and ESD entries, as followsi 

• The RLD relocation pointer (R pointer) gives the ESD ID for 
the symbol referred to by the address constant. 

• The RLD position pointer (P pointer) gives the ESD ID for 
the CSECT in which the address constant occurs. 

Figure 4 on page 7 illustrates the two cases of RLD pointers. 

The text of CSECT A contains two address constants, X and Y. X 
refers to a symbol within CSECT A. Therefore, both pointers of 
its associated RLD entry give the ESD ID of CSECT A. The value 
field of Y, however, refers to a symbol in a different control 
section, CSECT C. Thus, the R pointer of the entry for Y gives 
the ESD ID for CSECT C, the external reference; the P pointer 

gives the ESD ID for CSECT A. 

\ 


In an object module, an ESD item with type=LD can not have 
associated text or dependent address constants (see "ESD 
Processing"), and so is excluded from the numbering system. 
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Note : The module above includes an external symbol dictionary, text, and a relocation dictionary* 

The entry in the ESD for CSECT C results from the reference to CSECT C in the text of CSECT A. 
This reference is at location 400. (CSECT B has no relocatable 8ddre$s constants.) 

Figure 4. Example of an Input Module 


LOADER OPTIONS 

User options may be specified by parameters listed on the EXEC 
job control statement 4 , or may be passed internally by a program 
requesting the loader via LINK, LOAD, ATTACH, or XCTL macro 
instruction. 5 If the options are not user specified, the 
defaults provided by the loader are used. 

If the options are passed internally, the user can also provide 
alternatives for the standard ddnames and for the standard 
SYSLIN and SYSLIB DCBs. 


4 See JCL manual. 


5 See Supervisor Services and Macros. 
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Figure 5 describes the loader options. The parameters used are 
listed with the associated options. For some options* there are 
different parameters to specify either the choice or the refusal 
of the option. For example* NOCALL signifies that the library 
call option (CALL) is not to be used. (In this case* the third 
possible parameter has been retained for compatibility with the 
linkage editor option NCAL.) Figure 5 also indicates the 
default options. 


Parameters 

Options 

Defaults 

RESINORES 

The loader searches the link pack area queue for 
resident modules after primary input is complete* 
but before the SYSLIB data set is opened. 

RES 

MAPI NONAP 

The loader produces a list of external names and 
their actual storage addresses. 

NOMAP 

CALLI 

NOCALL| 

NCAL 

The loader performs an automatic search of the 
SYSLIB data set for unresolved external names. 

CALL 

LETINOLET 

The loader passes control to the loaded program 
despite the occurrence of a severity 2 error 
condition during loading. 

NOLET 

SIZE 3 

Specifies the maximum amount of dynamic storage to 
be obtained for loader processing. 

SIZE s 300K 

EP= 

Specifies an external name to be used as the entry 
point of the loaded program. 

No 

default 1 

PRINT I 
NOPRINT 

The loader attempts to open the SYSLOUT data set 
for diagnostic output. 

PRINT 

TERMI 

NOTERN 

Error messages are directed to the SYSTERM data 
set as well as the SYSLOUT data set. 

NOTERM 

NAME 3 

Specifies the name to be used as the name of the 
loaded program. 

GO 1 


Figure 5. Loader Options 


Note to Figure 5: 

1 The loader assigns an entry point to the loaded program if 
no name was specified. 


GENERAL THEORY OF OPERATION 

In processing the input modules* the loader assigns 
virtual-storage addresses to the control sections to be included 
in the loaded program* and resolves external references in the 
CSECTs. 

Because each input module has an origin that was assigned 
independently by a language translator* the order of the 
addresses in the input is unpredictable. (Two input modules* 
for example* may have the same origin.) The loader assigns an 
address to the first control section and then assigns storage 
addresses* relative to this origin* to all other CSECTs. 

Because cross-references between CSECTs in different modules are 
symbolic* they are resolved (translated into machine addresses) 
relative to the virtual-storage addresses assigned to the loaded 
program. 
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METHOD OF OPERATION 


This section describes the logic of the loader. It contains an 
introduction that emphasizes the flow of primary data and 
control information through tables and buffers. This section 
also contains detailed functional descriptions of the loader. 

The logic introduction refers to the operation diagrams 
associated with a particular function. The detailed functional 
descriptions refer* through lettered references* for example* 
(A)* to a portion of a diagram* to the corresponding steps of a 
function as shown in the operation diagrams. (The diagrams 
follow the text of this section.) 

At the end of this section are illustrations of the internal 
loader tables at strategic points in processing (Figure 13 on 
page 25). These illustrations stress the changes to data; the 
diagrams stress movement of data* Used together* the two sets 
of figures offer quick recall. 


STEPS OF THE LOADER OPERATION 

The loader control portion* which acts as an interface with the 
supervisor* loads the processing portion of the loader and 
passes to it the parameter list received. The system interface 
is shown in "Diagram Al. Overall Loader Operation" on page 47 
and "Diagram A2. Loader Invocation" on page 48. The loader then 
performs loading through the following basic functions! 

• Initialization 

• Input control and buffer allocation 

• Primary input processing 

• Secondary input processing 

• Final processing 

• End of loading 

After the processing portion has completed these functions* the 
loader control portion passes control to the loaded program for 
execution. 

The overall flow of data and control during loading is shown in 
"Diagram Al. Overall Loader Operation" on page 47. 


Initialization 


Hhen the loader begins processing* it performs initialization in 
preparation for all subsequent processing. The operations 
included in initial processing ares 

• Analyzing control information 

• Initializing virtual storage 

• Initializing DCBs and opening data sets 

"Diagram Bl. Loader/Scheduler Interface and Initialization" on 
page 49 shows initialization processing. 
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Input Control and Buffer Allocation 

The loader reads input and allocates buffers as required for the 
current input module. Object modules from SYSLIN (primary input 
data set) and from SYSLIB (secondary input data set) are read 
into the object module buffers. (However, if input is an 
internal data area, buffers are not allocated and the data area 
itself is considered one buffer.) Control information from load 
modules (including ESD and RLD records) is read into the RLD 
buffer. Text from load modules is read directly into the loaded 
program's storage area. "Diagram Cl. Primary Input Control and 
Buffer Allocation" on page 50 shows input control and buffer 
allocation. 


Primary Input Processing 

The loader performs the following processing for all SYSLIN 
modules. (All overlay and scatter control statements from load 
modules and SYM records are ignored.) "Diagram Dl. Object 
Module Processing” on page 51 and "Diagram D2. Load Module 
Processing" on page 52 show primary input processing. 


External Symbol Dictionary Processing 

The ESD records from object modules and CESD records from load 
modules describe symbols that have been defined for external 
use. The loader makes entries for the symbols in the CESD, and 
also makes entries in the translation table to allow the 
translation of the input ESD IDs to CESD addresses. The loader 
calculates storage addresses and stores them in the CESD 
entries. "Diagram D3. ESD Record Processing (Generalized)" on 
page 53 through "Diagram D6. Example of ESD ID Translation" on 
page 56 show external symbol dictionary processing. 


Text Record Processing 

For object modules, the loader translates the ID of a text 
record to the proper CESD entry address. The CESD entry 
contains the storage address assigned to the CSECT. When the 
loader finds the address for the text, it moves the text from 
the object module's buffer to the loaded program's storage. For 
load modules, the loader translates the IDs of all CSECTs in a 
text record and thus finds their assigned virtual-storage 
addresses. The loader reads the record directly into the loaded 
program's storage area; CSECTs at the end of the record that are 
to be deleted are not read; CSECTs within the record that are to 
be deleted are overlaid when the CSECTs that are to be kept are 
compressed. "Diagram D7. Object Module Text Processing" on 
page 57 and "Diagram D8. Load Module Text Processing" on page 58 
show text record processing. 


Relocation Dictionary Processing 

The loader builds its RLD table from information contained in 
the RLD records. It processes the RLD records of object modules 
from the object module buffer, and those of load modules from 
the RLD buffer. The loader uses the relocation and position (R 
and P) pointers to determine the addresses of the address 
constants (adcons), and uses the flag field to determine the 
method of address constant relocation required. "Diagram D9. 

RLD Record Processing” on page 59 shows relocation dictionary 
processing. 
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Address Constant Relocation Processing 


Hhen external references in the CESD are resolved# the loader 
uses the RLD table entries chained to the CESD entry to relocate 
the related address constants in the loaded text* 


Secondary Input Processing 

If there are unresolved external references after all SYSLIN 
input has been processed# the loader tries to resolve them from 
system library routines. If RES is specified# the loader first 
tries to resolve the references from link pack area routines. 
Hhen this is possible# the loader uses the addresses of the 
referenced routines in the link pack area to resolve the adcons 
used to symbolically refer to them. Finally# the loader opens 
the SYSLIB data set* if necessary. The loader then loads any 
library modules that can be used to resolve ERs in the loaded 
program. The modules are located via the BLDL and FIND macro 
instructions. The loader processes the modules# depending on 
whether they are object or load modules, in the same manner as 
it processes primary input. "Diagram El. Secondary Input 
Processing" on page 60 shows secondary input processing. 


Final Processing 


After processing all the input for the loaded program# the 
loader performs the following: Assigns addresses for the common 
areas and for displacements in the external dummy section# 
issues messages for unresolved ERs# and determines the address 
of the loaded program's entry point. 


Identifying Loaded Program 

If program loading is successful# the loader issues an IDENTIFY 
macro instruction to pass the name of the program to be executed 
to the control program. 6 At this time# a condensed symbol table 
may also be constructed for use during the program's execution 
by the test facilities available under the Time Sharing Option. 


End of Loading 


Before ending loader processing# the loader performs the 
following: writes out the diagnostic message dictionary and any 
remaining diagnostic messages# closes data set DCBs# sets up 
return information# and frees storage not required for the 
loaded program. 


INITIALIZATION IHEWLIOCA) 

Hhen the loader begins processing# it analyzes control 
information# performs initialization of main storage and of data 
sets# and allocates initial buffers for the data sets. See 
"Diagram Bl. Loader/Scheduler Interface and Initialization" on 
page 49. 


This processing is performed only when the processing 
portion of the loader is invoked# either directly or by the 
control portion of the loader# by the name HEHLOAD. 
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ANALYZING CONTROL INFORMATION 

Loader operation depends on the control information# consisting 
of the options# ddnames of the data sets# and the data control 
block addresses# to be included in loader processing. The 
loader uses the information passed by the user or the defaults. 
(The defaults are contained in the control section HEHLDDEF.) 

(A) To analyze the control information# the loader obtains a 
temporary work area# INITMAIN. (See "Data Areas" on page 73 for 
the contents of INITMAIN.) The loader saves# in the temporary 
work area# the default ddnames and option indicators. An 
EXTRACT macro instruction is then issued to determine whether 
the loader is currently operating under the Time Sharing Option# 
and an indicator is set in INITMAIN. If the processing portion 
of the loader was invoked through the entry point HENLOAD# 
another indicator is set to show that identification of the 
loaded program is desired. The loader then scans the user's 
options and resets the default indicators in INITMAIN# when 
necessary. 

If the SIZE option is specified# the associated user's value 
replaces the default value. However# if the option is 
incorrectly specified# the default value is used. 

If the EP option is specified# the associated entry point name 
is saved in INITMAIN. 

If the NAME option is specified# the associated program name is 
saved in INITMAIN. Otherwise# the default name XXGO is used. 

The loader then checks for user-specified ddnames to be used in 
specifying data sets. If present# these ddnames also replace 
the default names. 

Finally# a check is made for the addresses of alternates for the 
data control blocks. Both addresses# if specified# must be 
24-bit-only addresses; otherwise# they are ignored. A SYSLIN 
control block is accepted if it describes an internal data area. 
The address of this control block is saved# and an indicator for 
an internal SYSLIN data area is set in INITMAIN. (The SYSLIN 
control block# which is not a data control block# is described 
in "Internal SYSLIN Control Block" under "Compiler/Loader 
Interface for Passed Data Sets” in the Appendix.) An alternate 
SYSLIB DCB is accepted if it describes a data set that has been 
opened. The address of this DCB is also saved and an indicator 
for an open library data set is set in INITMAIN. 


INITIALIZING VIRTUAL STORAGE 

(B) Using the GETMAIN macro instruction# the loader obtains the 
required storage from the supervisor. The request is 
conditional and variable. The maximum amount requested is that 
specified by the SIZE option; the minimum is 2K bytes. If the 
supervisor does not return storage# the loader then issues an 
unconditional GETMAIN request for the minimum. If 2K bytes of 
storage is still unavailable# an 804 or 80A system abend occurs. 

If the supervisor returns virtual storage space# the loader 
establishes its permanent communication area. (The 
communication area is described in "Data Areas" on page 73.) 

The loader then moves the information stored in INITMAIN to the 
communication area. 

Save areas for use during loading are allocated and chained 
backward and forward. Finally# the INITMAIN area is returned to 
the system via a FREEMAIN macro instruction. The area is then 
available for data management functions required for loading. 
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READYING DATA SETS 


(C) The loader performs initialization requisite to use of its 
data sets. If the TERM option has been specified# space is 
reserved for a SYSTERM DCB# two DECBs# and two buffers. Unless 
an internal SYSLIN data set has been passed to the loader# a 
SYSLIN DCB must be prepared and opened. Similarly# unless the 
NOPRINT option has been specified# a SYSLOUT DCB must be 
prepared and opened. 

DCBs for the data sets are constructed using a model DCB 
contained in the loader. The ddnames and basic attributes are 
placed into the constructed DCBs before the data sets are 
opened. 

During opening# other data set attributes are checked. These 
include record format# record and block sizes# and the number of 
buffers to be allocated for the data set. If record and block 
sizes are not defined# the loader uses the following defaults* 

• For SYSLIN# both values are set to 80. 

• For SYSLOUT# both values are normally set to 121. However# 
if the loader is operating in time-sharing mode# the record 
length of the SYSLOUT data set is set to 81 so output can be 
easily directed to a terminal. 

Because the loader allocates buffers for its data sets# it does 
not require the buffer allocation supplied by the Open routine. 
The loader indicates this by setting the DCBBUFNO field in the 
DCB to zero. The value that was found in the DCBBUFNO field is 
stored in DCBNCP. 

The loader determines whether the data sets opened successfully. 
If SYSLOUT is open# the loader allocates the number of buffers 
and DECBs specified in the DCBNCP field in the DCB# and sets a 
flag indicating that the SYSLOUT data set is usable. The 
diagnostic output page heading is set up and printed. The 
loader then constructs# in the SYSLOUT buffer# a list of the 
options used# the amount of virtual storage received for loader 
processing# and the entry point and program names# if specified. 
After printing this list# the loader prints out any invalid 
options received and any errors encountered during the open 
procedure. Finally# if the MAP option was chosen# the MAP 
heading is constructed and printed. 

If the opening of SYSLOUT was not successful# the MAP option 
indicator is set off and the storage allocated for the data 
set v s DCB is released. 

Next# the loader determines whether the SYSLIN data set opened 
successfully. If an error occurred during opening of SYSLIN# 
loading is terminated. If SYSLIN opened properly# the loader 
sets the "unlike attributes" indicator in the DCB to signify 
that SYSLIN may be a concatenation of data sets with unlike 
record formats. The buffers for the first input module are then 
allocated as described under "Buffer Allocation” on page 15. 


INPUT CONTROL AND BUFFER ALLOCATION 

To read input# the loader determines whether the current input 
consists of object or load modules# and whether it resides on an 
external device or in virtual storage. This is indicated by 
indicators (CMFLAG3) in the communication area as well as the 
record format of the DCB. (The format is undefined (U) for load 
modules# fixed (F) for either object modules on an external 
device or internal object modules# and variable (V) for internal 
object modules.) If the input data set resides on an external 
device# buffers are allocated and primed. If the input data set 
is an internal data area consisting of internal object modules# 
no allocation or priming of buffers occurs and the data area 
itself is considered one buffer. In any case# the records are 
read and processed until the end of the current data set is 
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recognized# either through the end-of-concatenation or 
end-of-file condition for a data set residing on an external 
device# or through the end-of-buffer condition for an internal 
data area. 7 (No check for the END card or EOM indication is 
made during the reading procedure; the end condition is only 
recognized when the record is processed.) When the end of the 
current input is reached# the loader checks for additional 
SYSLIN input.® 

Another data set in SYSLIN is indicated unless both the 
end-of-file and end-of-concatenation switches are on. When the 
loader opens a new data set in SYSLIN input# the loader 
determines the new attributes. This is accomplished by the same 
procedures used during loader initialization for the first input 
data set. 


BUFFER MANAGEMENT IHEWBUFFR) 

In general# the loader allocates storage individually for DECBs 
and buffers. Thus# for a single data set# buffer allocation 
actually consists of several separate allocations. These 
allocations are made from contiguous storage whenever feasible. 
All allocations are made from the highest available address in 
loader processing storage. When no longer needed# allocated 
space is made available for subsequent modules. 


Buffer Deallocation 


If both the current input and the previous input consist of load 
modules# the loader uses the same buffer and DECBs. This is 
possible because the buffer-DECB requirement for load modules is 
constant. Figure 6 on page 15 illustrates the buffer and DECBs 
required for reading load modules. If either the current or the 
previous data set consists of object modules# the loader frees 
(deallocates) the storage used for the previous buffer-DECB 
allocation. 

A pointer to the first freed area is maintained at CMFRECOR. 

(See Figure 7 on page 16.) The first A bytes of each freed area 
are used to store a pointer to the next freed area in the chain. 
The second A bytes give the size of the current area. (The size 
is always rounded to doubleword value.) See Figure 7 for an 
illustration of freed area chaining. 

Before chaining an area deallocated from a DECB or a buffer# the 
loader checks the area's location against the pointers of the 
other areas in the chain for contiguity. Contiguous freed areas 
are combined under a single pointer. For example# in Figure 7# 
Freed Area 1 could consist of areas from three separate 
deallocations * One of each DECB and one for the buffer. 


End-of-buffer signifies both end-of-file and 
end-of-concatenation for an internal data area. 

The end-of-concatenation switch is set during the data set 
opening if another data set is concatenated to the current 
one. If there is no other SYSLIN input# the 
end-of-concatenation and end-of-file switches are both set 
on. They are tested at the end of each module. 


14 MVS/370 Loader Logic 


LY26-3922-1 © Copyright IBM Corp. 1972, 1985 



Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


CMRDCBPT 



CMRDECPT CMGETREC 



♦ 


256 

bytes 


t 


Note: CMRDCBPT, CMRDECPT, and CMGETREC are 

pointers m the communications area (HEWLDCOMj. 


Figure 6. Load Module Storage Allocation for Buffer and DECBs 


Buffer Allocation 


After freeing any previously used buffers* the loader allocates 
DECBs and buffers for the current input module. For object 
module input* a DECB is allocated and cleared* and the address 
of the DCB is stored in it; then* the related buffer is 
allocated and its address stored in the DECB. (The size of the 
buffer is obtained from DECBBLKSZ; the number* from DCBNCP* 
where the value from DCBBUFNO was stored.) The allocation 
procedure is repeated until the specified number of buffers has 
been allocated. However* after the first time* each DECB is 
chained to the one before. The last DECB is chained to the 
first. (See Figure 8 on page 17 for an illustration of an 
allocation for object module input.) The loader also sets a 
pointer to the DECB chain in the communication area at CMRDECPT* 
sets the I/O flags to indicate object module input* and saves 
the buffer size in the communication area for later 
deallocation. 

For load module input* the loader allocates the required two 
DECBs* clears them* chains them together* and stores the address 
of the DCB in them. The required buffer* called the RLD buffer* 
is then allocated and its address stored in the first DECB. The 
loader stores a pointer to this buffer in the communication area 
at CMGETREC* and a pointer to the first DECB in CMRDECPT. (Mo 
buffer is allocated for load module text). The loader reads 
load module text directly into the loaded program v s storage 
area. The RLD buffer size is stored in the DECB* and finally 
the I/O flags are set to indicate load module input. 

In allocating buffers and DECBs for load or object module input* 
the loader attempts to reuse any storage freed from previous 
allocations. The loader examines each entry in the freed area 
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CMFRECOR 


Communications Area (HEWLDCOM) 


High Address 


Freed Area 1 


Freed Area 2 


Note: 

304 is the size of 
Area 1. 

240 is the size of 
Area 2. 


Low Address 



Loader Processing Storage 

Figure 7. Freed Areas from Buffer-DECB Allocation 


chain to determine whether the related storage is sufficient for 
the current DECB or buffer. 

If the area is too small* the next entry is tested. If the size 
of an area equals the required size (rounded to doubleword 
value)* the loader unchains the area and constructs the buffer 
or the DECB. If the size of the freed area is greater than that 
of the required area* the chain pointer for that area is updated 
to show the size and location of the remainder. 

If no area in the chain is adequate for the current buffer or 
DECB* the loader makes the allocation from its processing 
storage not previously allocated (prime storage). If this 
allocation requires an area so large that it would exhaust the 
table and buffer area* the loading process is terminated* with a 
message printed to indicate that available storage was exceeded. 


READING OBJECT NODULE INPUT FROM AN EXTERNAL DEVICE 

Because of the fixed format of object module records* the loader 
can initiate the reading of physical sequential blocks before 
they are actually needed for processing. To accomplish this* 
the loader primes the buffers after allocating them for object 
modules. Priming consists of initiating READ macro instructions 
for all buffers except one. When the loader requires the first 
record for processing* a READ macro instruction is issued for 
the unfilled buffer* and a CHECK macro instruction is issued for 
the first buffer primed. 
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CMRDCBPT CMRDECPT CMGETREC 



located in HEWLDCOM . CMRDECPT points to 
the DEC ft/buffer being processed. CMGETREC 
points to the logical record being processed. 


A 


Y 


Figure 8. Storage Allocation of Buffers and DECBs for Object Module Input 


At the beginning of processing for a module, the DECS pointer 
(CMRDECPT) specifies the DECB associated with the first primed 
buffer (see Figure 8.) The pointer to the current logical 
record also specifies the beginning of that buffer. As each 
record is processed, the loader updates the logical record 
pointer to the next record. Mhen all records in the buffer have 
been processed, the loader updates the DECB pointer to the one 
for the next filled buffer, and issues a READ macro instruction 
for the completed buffer. The procedure is repeated until the 
end of the module is recognized. 


READING INTERNAL OBJECT MODULE INPUT 

For internal object modules prepared by a compiler, record 
format may be fixed or variable. After initialization of the 
data area containing the internal object module records, the 
pointer to the current logical record points to the beginning of 
the data area. As each new logical record is requested, the 
loader updates the pointer to the next record in the data area, 
using the DCBRECFM field in the SYSLIN control block to 
determine whether fixed- or variable-length records are being 
processed. The end of the module is recognized when the length 
of the processed records equals the length specified in the 
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DCBBLKSI field* At this time, the end-of-file and 
end-of-concatenation switches are set on* 


READING LOAD MODULE INPUT 

For load modules, the record format is undefined, but the order 
in which record types may be processed is limited* For example, 
control records are required before the related text record can 
be read. All nontext records of load modules are read into the 
same buffer. This buffer, the RLD buffer, has the same length 
as the maximum length of nontext records processed by the loader 
(256 bytes). 

The loader allocates a DECB for reading load module text, but no 
buffer, because the text is read directly into the loaded 
program's assigned area. The loader determines the address to 
receive the text during module processing. At the time a text 
record is read, the following record is also read, because that 
record is always nontext. 


PRIMARY INPUT PROCESSING 

After determining the current record type, the loader performs 
one of the following types of processing for the primary input 
(object and/or load modules from the SYSLIN data set)* 

• External symbol dictionary (ESD) processing 

• Text record processing 

• Relocation dictionary (RLD) processing 

• Address constant relocation processing 

• End processing (including end of module and END card) 

• MOD record processing 

If an invalid record type is encountered, a diagnostic message 
is issued. In addition, if an internal input data area is being 
processed, the end-of-concatenation and end-of-file switches are 
set on so that no further input will be processed. 

Figure 9 shows the differences in processing for object and load 
modules. Input module processing for object and load modules is 
shown in "Diagram D1. Object Module Processing" on page 51 and 
"Diagram D2. Load Module Processing" on page 52 respectively. 


Type of 
Processing 

Object Module 

Load Module 

ESD 

1. Input is an ESD record. 

2. The loader performs preliminary 
processing for NULL, PC, and LD 
entries. 

1. Input is a CESD record. 

2. The loader performs 
preliminary processing for 

SD, LR, PC, and NULL 
entries. 

Text 

The loader processes text from the 
object module buffer one ID at a 
time. 

After processing the entire 
ID/length list, the loader reads 
load module text directly into 
the loaded program's storage 
area. 

RLD 

No difference. 

No difference. 


Figure 9 (Part 1 of 2). Object and Load Module Processing Differences 
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Type of 
Processing 

Object Nodule 

Load Nodule 

Relocation 

No difference. 

No difference. 

End 

The loader processes the END state¬ 
ment for each CSECT, and performs 
end-of-module processing. 

The loader performs 
end-of-module processing. 

NOD 

(internal 

object 

modules 

only) 

The loader determines the origin of 
the compiler-loaded text for the 
module and equates this address 
with what would normally be the 
loader-assigned address. 

Not processed. 


Figure 9 (Part 2 of 2). Object and Load Module Processing Differences 


Load module record types include composite ESD, control, RLD, 
control/RLD, text, SYM, IDR and scatter/translation. When the 
loader recognizes a SYM, IDR, or scatter/translation record, if 
simply ignores that record and requests another control record. 
Descriptions of those load module records processed by the 
loader follow. (For detailed descriptions, see the record 
formats given in the Appendix.) 

• CESD: Each of these records contains no more than 15 ESD 
entries. 9 The first 8 bytes give the following control 
information for the entries in that record! (1) the ESD ID 
of the first entry, (2) the number of bytes occupied by the 
entries, and (3) an indication of whether the CESD entries 
contain overlay segment numbers, or AMODE and RMODE data. 

• Control i These records give control information about the 
module text on the following text record. Included are the 
related ESD IDs and the lengths of each control section in 
the following text record, and an indication of EOM, when 
pertinent. The control records also contain a channel 
command word (CCN) with the linkage editoreassigned relative 
address and total length of the text record. The loader 
uses this information to read the text. 

• Text* These records contain the control sections with the 
instructions and data of the module. A text record can 
contain a maximum of 60 control sections. 

• RLD: These records contain the RLD entries used to relocate 
address constants in the preceding text. Hhen the text 
contains a large number of relocatable symbols, the related 
RLD entries may require several records. 

• Control/RLD: These records combine a control and an RLD 
record into one physical block. They contain RLD entries 
related to a previous text record, and the control 
information for the following text record. 

The object module records, ESD, RLD, TXT, and END, contain 
information similar to that described previously. In addition, 
an internal object module can contain the MOD record. This 
record contains control information about the text of the 
module, which has already been loaded by a compiler or other 
text-generating processor. This information includes the 
virtual storage address of the text, the address of the byte 
following the estimated or actual end of the text, and optional 
extent information. If a MOD record appears as the first record 
of an internal object module, all following text records are 
ignored until an END statement has been processed. 


The loader can accept a maximum of 1024 ESD entries per 
input module. 
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EXTERNAL SYMBOL DICTIONARY (ESDI PROCESSING (HEWLESD) 

The loader processes the input modules' external symbol 
dictionary (ESD) records to resolve the symbols used in internal 
and external addressing. Resolution ensures that each named 
location in the text for the loaded program has a unique 
symbol. 10 

To resolve symbols* the loader builds its composite ESD (CESD) 
from individual ESDs and CESDs in the input. The loader's CESD 
entries are created as required during processing of the input 
entries. See "Data Areas" on page 73 for a detailed description 
of CESD entries. 

Because of ESD processing* the loader's CESD contains only one 
entry for each uniquely named text location* regardless of the 
number of input ESD entries containing the symbol for that 
location. 11 For a single module* the loader records multiple 
ESD entries for a symbol in the translation table. 12 Each entry 
in the translation table corresponds to one input ESD entry for 
a symbol* and contains a pointer to the CESD entry for the 
symbol• 

A translation table entry has the same position in the table as 
the identifying number (ESD ID) of the associated ESD entry. 

For example* if an input ESD entry has an ESD ID of three* its 
corresponding entry is the third one in the translation table. 
Using this relationship* the loader converts input ESD IDs via 
the translation table into the appropriate CESD address. 

The loader's ESD processing depends on the function of each 
input entry. The function of an entry is identified by the type 
indication in the entry. Figure 10 gives the function specified 
by each type indication. The table also indicates whether a 
particular type can occur in object and/or load module external 
symbol dictionaries. 

When the loader creates a CESD entry* it chains it to others 
with the same type indication. Then* in processing each new 
input entry* the loader determines* by searching the chains* 
whether a CESD entry with the associated symbol already exists. 
(The loader only searches those chains for types that could be 
related to the current input entry's type.) In certain cases* 
special preliminary processing is performed to delay or to 
bypass the CESD search. 

CESD processing is shown in "Diagram D3. ESD Record Processing 
(Generalized)" on page 53 through "Diagram D6. Example of ESD ID 
Translation" on page 56. 


10 Names for areas of private code or for external dummy 
section displacements need not be unique* because they are 
treated in a special way. These are defined by PC and PR 
entries* respectively. 

11 The only exception involves control sections with identical 
names. In this case* two entries* one of which is flagged 
"delete," are kept in the CESD. 

12 The loader clears the translation table after processing 
each module. 
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Type 

Function 

Occurrence 

Comments 

SD (section 
definition) 

Defines the 
beginning of a named 
CSECT. 

Object & load 

- J 

PC (private code) 

Defines the 
beginning of an 
unnamed CSECT. 

Object & load 

" 11 

PC (private code) 
marked "delete 1 * 

Defines the 
beginning of an 
unnamed CSECT not to 
be included in the 
loaded program. For 
example# a SEGTAB 
created by the 
linkage editor. 

Load only 

The delete 
indication means 
that the associated 
text and RLDs are to 
be deleted. 

LD (label 
definition) 

Defines a label by 
giving its location 
relative to the 
beginning of the 

CSECT containing the 
label. 

Object only 

The defined label 
cannot be referenced 
directly because the 
LD entry has no ESD 

ID. The loader 
changes the type to 

LR in the CESD 
entry. 

LR (label 
reference) 

Defines a label by 
giving its location 
relative to the 
beginning of the 

CSECT containing the 
label• 

Load only 

An LR entry contains 
an ESD ID and can# 
therefore# be 
referenced by an RLD 
entry. 

ER (external 
reference) 

Refers to a symbol 
not defined in the 
same module 
containing the 
reference. 

Object & load 


CM (common) 

Defines a common 
area whose virtual 
storage address is 
assigned during 
loading. 

Object & load 

The area may be 
named or unnamed. An 
unnamed area is 
called "blank 
common." 

PR (pseudo 
register) 

Defines a 

displacement within 
an external dummy 
section. 

Object & load 

The external DSECT 
defines the area 
obtained by the 
loaded program via a 
GETMAIN macro 
instruction. 

NULL 

Indicates that the 
entry is to be 
ignored. 

Object & load 

Only one entry for 
NULL is made in the 
loader's CESD. 

NX (weak external 
reference) 

Defines an external 
reference that is 
not to be resolved 
by automatic library 
call. 

Object & load 

The loader processes 
a WX entry as an ER 
entry with a "weak 
call" flag. 


Figure 10. ESD Entry Types and Functions 
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Preliminary ESD Processing 

Hhen the loader processes load modules, it does not necessarily 
receive CESD entries in the same order as the linkage editor 
assigned the relative addresses* Therefore, no entries for 
symbols that define module text locations are processed until 
all entries for the module have been received* 

The loader delays the processing by placing, on a temporary 
chain, the CESD entries it constructs for the SD, LR, and PC 
(not marked "delete”) entries. Before chaining an entry, the 
loader places the ID and the segment number in the CESD entry. 
The entries are chained in the order of their linkage 
editor-assigned addresses. 

Besides the preliminary processing for load module location 
definitions, the loader also determines whether an input entry 
type is NULL, PC, LD, LR, or HX. These entries, in both object 
and load modules, are handled as follows * 

NULL 

The loader does not perform a CESD search for NULL entries, 
because these entries have no effect on ESD resolution. 

Hhen the first NULL entry for a module is recognized, a 
CESD entry is created. This CESD entry is cleared and 
marked "delete." (See the CESD entry description in "Data 
Areas" on page 73.) The loader places a pointer to the 
entry in the communication area (CMNULCHN) and makes a 
translation table entry. (See "Making a Translation Table 
Entry" on page 27.) For all following NULL entries, 
processing consists only of making a translation table 
entry that refers to the CESD entry pointed to by CMNULCHN. 

PC 

The loader does not perform a CESD search for PC entries, 
because it treats them as unique. For each PC entry, the 
loader creates a CESD entry. Processing continues as 
described under "No-Match Processing" for SD entries. 

PC "delete" 

The loader treats PC entries that are marked "delete” as 
NULLs. 

LD and LR 

LD and LR entries depend on their related section 
definitions (SDs). Therefore, before performing the CESD 
search, the loader inserts the CESD entry address for the 
SD in the LD or LR entry. The address is obtained by 
translating the SD ID contained in the LD or LR. 

If an object module is the input, it is possible (through 
physical rearrangement of an object deck) to receive an LD 
before the related SD. The SD v s CESD entry address cannot 
be placed in the LD until the SD v s entry is created. 
Hhenever this occurs, the LD is placed on a temporary LD 
chain. At the end of each input ESD record, the temporary 
LD chain is processed to determine whether a required SD 
has been received. Hhen the SD associated with an LD has 
been received, its CESD entry address is placed into the 
LD. The loader then searches the CESD for a matching 
symbol. 


The loader treats HX entries as ER entries that are marked 
"weak call." The "weak-call" flag, like the "never-call" 
flag, specifies those external references that are not to 
be resolved by automatic library call. However, the 
following difference arises in match processings If a HX 
entry matches an ER entry in the CESD, the "weak-call" flag 
is set off. If an ER entry with a "never-call" flag 
matches an ER entry in the CESD, the flag is left on. 
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CESD Searching 


In general, an input ESD entry requires resolution processing. 
The loader does this by searching the CESD for a matching 
symbol. To direct the search, the loader uses two tables. 

These are: 

• HIERTBLE, which specifies which CESD chains are to be 
searched for a particular entry type, and the order in which 
the chains are to be searched 

• CMTYPCHM, which contains the address of the first entry in 
each CESD chain 

Figure 11 shows the relationship between the two tables. 

The loader determines the type of an input ESD entry and begins 
to search the first chain specified by HIERTBLE. (If the type 
is LD, the loader performs the search as if it were an LR.) The 
symbol from the input entry is compared to the symbol in each 
chained entry. If no matching symbol is found and end of chain 
is recognized, the next chain specified by HIERTBLE is 
searched. 13 If no matching symbol is found in any of the 
appropriate chains, a CESD entry for the symbol is created and 
chained. A translation table entry is also made, if 
appropriate. (See "No-Match Processing" on page 24.) If a 
matching symbol is found, symbol resolution occurs. (See "Match 
Processing" on page 29.) 


HIERTBLE 



Order of Type Cham -— -►- 

Search 


CMTYPCHN 


SD 

LD 

ER 

LR 

PC 

CM 

PR 

NULL 

Chain 

Chain 

Chain 

Chain 

Chain 

Chain 

Chain 

Chain 

Address 

Address 

Address 

Address 

Address 

Address 

Address 

Address 

0 

l 

2 

3 

4 

5 

6 

7 


Notes : 

The HIERTBLE entries identify by number the CMTYPCHN entries. 

For example, zero (0) in the HIERTBLE refers to the SD chain address in CMTYPCHN. 

When more than one type chain can be searched for a symbol, 
the order is specified by HIERTBLE. For example, if an input 
ESD entry is an SD, the HIERTBLE entry specifies that the ER, SD, CM, 
and LR chains are to be searched in that order. 


Figure 11. Tables Used in the CESD Search 


13 Whenever a new entry on a chain is examined, a pointer to 
that entry is stored in the communication area (CMPREVPT). 
Should the next entry on the chdin be a match, the pointer 
at CMPREVPT is used to update the chain. 
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No-Match Processing 


Mhen a symbol is received for the first time# the loader 
performs processing that depends on the type of the input entry 
for the symbol. This always includes the construction of the 
CESD entry# which differs by entry type. Except for LD entries, 
no-match processing also includes construction of a translation 
table entry. 

If the user specified the MAP option# the loader formats a map 
entry for each symbol (except ERs). See Figure 46 on page 96 
for an example of map output. The loader prints the map entries 
on the SYSLOUT data set. 

Figure 12 summarizes the processing performed for each input 
entry type. 


Input Entry 
Type 

CESD 

Entry 

Translation 

Table 

Entry 

Map 

Entry 

SD 

X 

X 

X 

LD 

X 


X 

LR 

X 

X 

X 

ER 

X 

X 


CM 1 

X 

X 

X 

PR 1 

X 

X 

X 


Figure 12. No-Match Processing Required for Input Entry Types 


Note to Figure 12: 

1 Because CM and PR entries are assigned addresses during 
final processing# they are also mapped at that time. 

MAKING A CESD ENTRY: For each input entry type# the loader 
makes a CESD entry. A NX entry type is treated as an ER input 
entry type with a "weak-call" flag. The loader first obtains 
the storage required for the entry (22 bytes). Nhenever 
possible# the loader uses storage previously allocated for CESD 
entries that were later freed. (A CESD entry can be freed as a 
result of preliminary ESD or of resolution processing.) The 
loader chains freed entries together. A pointer to the chain 
resides in the communication area at CMESDCHN; the pointer is 
updated as the freed entries are used. 

If there are no freed CESD entries# the loader allocates storage 
for the entry from the highest available processing storage. 

(See Figure 13 on page 25.) If the space required for the entry 
would exceed available storage# the loading process is 
terminated with an error message. The loader makes this 
determination by comparing the pointer for the beginning of the 
loader's tables (CMLOHTBL) to the overflow pointer that is the 
highest address used for the loaded program's text (CMLSTTXT). 
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CMHITBL 



CMMAINPT 


IddO Li 

/ 


Notes : CMBEGADR 
CMHITBL 
CMLOWTBL 
CMLSTTXT 
CMMODLNG 
CMNXTTXT 
CMMAINPT 


= Beginning address of loaded program 
= End address of Loader processing storage below the line 
= Lowest address allocated for buffers and tables 
= Highest address already used for the loaded program s text 

= Length of text already loaded for the current module, not including *no*length" CSECTs 
= Lowest address used for the current module 
= Beginning address of loaded program space 


Figure 13. Storage Allocation 
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After obtaining storage for the CESD entry# the loader stores 
descriptive information in the entry. The information stored 
depends on the input entry type. Handling of the various entry 
types is described below: 


The loader moves the symbol from the input entry to the 
CESD entry. 

The loader then assigns an address to the defined CSECT by 
adding the length of all previously defined CSECTs for this 
module to the loader-assigned address of the first CSECT in 
the module. (In the communication area# the length of all 
previously defined CSECTs is found at location CMMODLNG; 
the loader-assigned address of the first CSECT# if the 
CSECTs are being passed through text records# is found at 
CMNXTTXT; and the loader-assigned address of the first 
CSECT# if the CSECTs are being pointed to by MOD records# 
is found at location CMC0RE1•) For CSECTs pointed to by 
MOD records# the resulting address is stored in the CESD 
entry for the SD as the loader-assigned address of the 
CSECT. For CSECTs passed through text records# however# 
the resulting address is compared to the overflow 

pointei-the beginning address of the loader tables 

(CMLOHTBL). If there is no more unused storage# the 
loading process is terminated with an error message. 
Otherwise# the resulting address is stored in the CESD 
entry for the SD as the loader-assigned address of the 
CSECT. 

Next# the loader clears the CESD flag field# except for the 
entry's type indication# and computes the relocation 
constant. The relocation constant is computed by 
subtracting the input address (specified by the input SD 
entry) from the loader-assigned address. The loader stores 
the relocation constant in the CESD entry. 

If the option to specify the entry point name for the 
loaded program was used# the loader determines whether the 
SD with that name has already been received. If not# the 
loader compares that name to the symbol for the currently 
defined CSECT (the symbol in the CESD entry). If the names 
are the same# the loadei—assigned address is stored as the 
entry point address in CMEPADDR. 

For an SD entry# the loader determines whether the CSECT 
length specified in the input entry equals 0. If so# the 
loader sets the "no length" indicators in the communication 
area and in the CESD entry itself. If the length is 
positive# it is added to CMMODLNG to calculate the next 
CSECT address. If the MAP indicator is on# the MAP entry 
is made for the SD. 

Finally# the loader puts the CESD entry on the SD chain 
pointed to in the CMTYPCHN table. Chaining consists of 
storing the pointer to the last SD entry (found in 
CMTYPCHN) in the current CESD entry's chain pointer. Then 
the address of this entry becomes the current pointer in 
CMTYPCHN. After chaining the entry# a translation table 
entry is made. 

LD or LR 

The loader processes input LD entries in the same manner as 
input LR entries. The name from the input entry is moved 
to the CESD entry. Then the loader-assigned address for 
the defined label is determined by adding the relocation 
constant (found in the CESD entry for the related SD) to 
the input address of the LD or LR entry. If the 
instructions arid data for the module have been passed 
through text records# and if the loader-assigned address 
exceeds available storage# the loading process is 
terminated with an error message. Otherwise# the address 
is stored in the CESD entry. 


26 MVS/370 Loader Logic 


LY26-3922-1 © Copyright IBM Corp. 1972, 1985 



Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


The loader sets the type indication in the CESD entry to 
LR. Finally# the relocation constant is computed. This 
value equals the loader-assigned address minus the input 
relative address. The relocation constant also is stored 
in the CESD. If the related SD entry was marked "delete#" 
the loader makes an ER entry instead of an LR# and sets the 
"delink" flag in the entry to signify that all adcons 
referring to it should be adjusted. 


CM 

To make a CM entry# the loader uses two separately obtained 
20-byte areas. The first area obtained is used as an 
extension to the CM entry. In this portion# the loader 
stores the length and the address assigned to the common 
area in the input. Then the loader obtains the second 
20-byte area and stores in it the name for the common area 
and the entry's type indication. (This area is the one 
pointed to by the translation table and the CM chain.) The 
loader clears 3 bytes in the entry to be used as a pointer 
to related ERs# and sets a pointer in it to the extended 
portion of the CM entry. Finally# a translation table 
entry is made. 

PR 

For a PR entry# the loader moves the information describing 
the external DSECT from the input entry to the CESD entry. 
The 3-byte field to be used as a pointer to the related 
RLDs is cleared# and the entry is chained to the other PR 
entries. (PRs are chained according to their order in the 
input.) For a DSECT displacement definition# a translation 
table entry is also required. 

ER 

For an ER entry# the loader moves the name and type from 
the input entry to the CESD entry. If the input ER entry 
is marked "never call#" the loader sets the "never-call" 
indication in the CESD entry. If the input ER entry is 
marked "weak call," the loader similarly sets the 
"weak-call" indication. The loader then chains the ER 
entry to the other ERs and makes a translation table entry. 

MAKING A TRANSLATION TABLE ENTRYs The loader uses the 
translation control table to direct building of the translation 
table. 14 The translation control table consists of 32 fullword 
entries beginning at location CMTRCTRL in the communication 
area. Each entry is a pointer to a possible 32-entry extent to 
be allocated for the translation table. The loader allocates 
the extents as required# depending on the number of incoming ESD 
entries. 

The entries of one extent correspond to consecutive ESD IDs in a 
single module. For example# the entries of the first extent 
correspond to ESD IDs from 1 to 31# those of the second extent 
correspond to IDs 32 to 63; and so forth. (Because the initial 
4 bytes are used for indexing purposes# the first extent 
contains only 31 translation table entries.) Thus# the position 
designated for creation of a particular translation table entry 
depends on the ESD ID of the associated input entry. 

Figure 14 shows an illustration of the translation control table 
and the translation table. 

To make a translation table entry# the loader first determines 
whether the input ID is valid. ("Diagram D6. Example of ESD ID 
Translation" on page 56# reference (A).) If an ID is not valid# 
an error message is printed and loading continues with the next 
input ESD entry. An ID is not valid if it is less than 1 or 
greater than 1023. 


14 For each input module# the loader reinitializes the 
translation table. 
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CMTRCTRL 



TRANSLATION 
TABLE EXTENTS 

Figure 14. Translation Control Table and Translation Table 


If an ID is valid* the loader then determines* by examining the 
translation control table* whether the extent for this ID has 
been allocated. If not* the loader allocates an area for 
thirty-two 4-byte entries* and stores the beginning address of 
the area in the translation control table entry for this extent. 
The area is allocated from the highest available storage in the 
loader's table and buffer space. If not enough loader 
processing storage remains to make the allocation* loading is 
terminated with an error message. 

After the extent allocation has occurred* the loader clears the 
extent. The loader then calculates the entry address in the 
extent for this ID. The address of the CESD entry related to 
the input entry ID is stored in the translation table entry. 

If the CESD entry is an ER* the loader sets the high-order bit 
of the first byte of the translation table entry to 1. (This 
indicates absolute relocation.) 

Figure 15 on page 29 shows the overall relationship of tables 
used in ESD processing. 
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Translation Control Table 
(CMTRCTRL) 



Match Processing 


If the loader finds a match for an input symbol during the CESD 
search/ the loader performs symbol resolution. Through 
resolution/ the loader ensures that each named location within 
the text of the loaded program has a unique symbol. 15 Also# all 
references to a named location are set to the correct 
loadei—assigned virtual storage address. 

If two named locations have the same symbol/ only one of them 
can be retained for the loaded program. The loader determines 
which is retained on the basis of ESD entry type. The general 
rules used in symbol resolution follow. 

If the entry already in the CESD has type* 

SD/ it is always retained. 

LR/ it is always retained. 

CM/ it is retained/ except when the input type is SD. 

ER/ it is always changed to the input type. 


15 This does not refer to PC AND PR names/ which need not be 
unique. 
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If two entries have matching symbols and have types that 
indicate they should be retained* the loader retains the first 
entry received. 

Figure 16 gives a summary of symbol resolution. 


Input Type 

CESD Type 

Result 

SD 

ER 

SD 


SD 

SD 


CM 

SD 


LR 

LR 

CM 

CM 

CM 


ER 

CM 


SD 

SD 


LR 

LR 1 

LD/LR 

ER 

LR 


LR 

LR 


SD 

SD 2 


CM 

CM 2 

ER 

SD 

SD 


ER 

ER 


LR 

LR 


CM 

CM 


Figure 16. Symbol Resolution 


Notes to Figure 16: 

1 Match results in an error. 

2 Match results in an error if the SD for the LD/LR is not 
marked "delete." 

INPUT ENTRY TYPE IS SD: 

CESD type is ER 

The loader changes the ER entry in the CESD to an SD entry. 
The entry is made as described under "No-Match Processing" 
for an SD entry. This includes: chaining the entry to 
other SDs* updating the cumulative length of the loaded 
program* determining whether this is the loaded program's 
entry point name* mapping the entry* and making a 
translation table entry. If RLDs were chained to the ER 
entry* they are relocated as described under "Relocation 
Processing." Also* the loader takes the entry off the ER 
chain* using the pointer to the previous entry on the chain 
(CMPREVPT). If there are no previous entries* the loader 
sets the ER entry in the type chain table (CMTYPCHN) to 0. 

CESD type is SD 

If the original SD is not flagged "delete*" the loader 
obtains space for another CESD entry and moves the name and 
loader-assigned address of the original entry into the new 
one. The relocation constant is then computed by 
subtracting the input address from the loader-assigned 
address. A "delete" indicator is set to show that text and 
RLDs related to the current input SD should be deleted. If 
the text for the CSECT has been pointed to by a MOD record 
rather than having been passed through text records* the 
text cannot be deleted and* thus* the cumulative module 
length (CMMODLNG) is updated to include this CSECT. 

Finally* the entry is chained to existing SD entries and a 
translation table entry is made. If the original SD is 
flagged "delete*" the original entry is used. 
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CESD type is CM 

The loader changes the existing CM entry to an SD. Because 
the extended portion of the CM entry is no longer needed/ 
the loader chains it to the freed CESD entries (pointed to 
by CMESDCHN). First/ however/ the loader obtains the 
length of the common area from the extended portion. For 
the SD entry/ the loader retains the greater between this 
length and the one specified in the input SD. To change 
the CM entry to an SD/ the loader performs the same 
processing described above for the SD-ER match. 

CESD type is LR 

The loader sets the "delete" indicator in the CESD entry so 
the text associated with the input SD will not be loaded. 
The relocation constant is updated to reflect the 
difference between the relative address in the input entry 
and the loader-assigned address in the CESD entry. The 
loader makes a translation table entry referring to the 
existing LR entry in the CESD. 

INPUT ENTRY TYPE IS CM: 

CESD type is CM 

The loader determines the greater of the length in the 
extended portion of the CESD entry and the length specified 
in the input CM. This greater length is retained in the 
CESD entry. The loader stores the new input address in the 
extended portion of the CM entry. A translation table 
entry is also made. 

CESD type is ER 

To change an ER entry to a CM, the loader obtains a 22-byte 
area for the extended portion and chains it to the existing 
entry. The loader stores the type, address, and length 
from the input entry in the extended portion of the CESD 
entry. The CM type indication is set, and the entry is 
unchained from the ERs. The loader chains the entry to the 
other CMs and makes a translation table entry. 

CESD type is SD 

The relocation factor in the CESD entry is updated to 
reflect the CM relative address, and a translation table 
entry is made. 

CESD type is LR 

The loader issues an error message for matching symbols 
with conflicting types. Nevertheless, the relocation 
constant is updated and a translation table entry is made. 

INPUT ENTRY TYPE IS LD OR LR: With one exception, LD and LR 

entries are processed in the same way. The difference is that, 

because an LD entry has no ESD ID, the loader does not make a 

translation table entry for an LD. 

CESD type is ER 

The loader changes the ER entry to an LR. The loader 
assigns a virtual storage address for the symbol by adding 
the relocation constant from the related SD entry to the 
relative address in the input LR. Next, the loader 
calculates the relocation constant by subtracting the input 
address from the loadei—assigned address. Both the 
relocation constant and the loadei—assigned address are 
stored in the LR entry in the CESD. Any RLDs that were 
chained to the ER entry are relocated. The loader checks 
the LR name for the user-specified entry point and makes a 
MAP entry if mapping is required. Then, the loader takes 
the CESD entry off the ER chain and chains it to the LR 
chain. If the input entry was an LD, no translation table 
entry is made. Otherwise, the loader makes a translation 
table entry. 

CESD type is LR 

If the SD entry pointed to by the LR is not marked 
"delete," the loader issues an error message for matching 
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symbols with conflicting types. In any case* the loader 
updates the relocation constant in the existing CESD entry. 
The loader makes a translation table entry referring to the 
LR in the CESD if the input entry was an LR from a load 
module. If not, a translation table entry is required. 

CESD type is SD 

Processing is the same as that described above for an 
LD/LR-LR match. 

CESD type is CM 

The loader saves the input address in the extended portion 
of the CM entry. The loader makes a translation table 
entry only if the input entry was an LR from a load module. 
If the SD pointed to by the LR entry is not marked 
"delete," the loader issues an error message for matching 
symbols with conflicting types. 

INPUT ENTRY TYPE IS ERs Whenever the loader makes a translation 
table entry for an input ER, it sets an indicator for later use. 
(The indicator signifies during RLD processing that the 
loader-assigned address is to be used for relocation of any RLDs 
with this ID.) 

CESD type is SD 

The loader makes a translation table entry referring to the 
SD entry. 

CESD type is ER 

If the input ER is marked "never call," the loader also 
sets the "never-call" indicator in the CESD entry. If the 
"delink" indicator is on, the loader sets the indicator 
off. In any case, a translation table entry is made 
referring to the ER entry in the CESD. If either ER is 
marked "weak call," the "weak-call" flag is set off. If 
both ERs are marked "weak call," the flag is left on. 

CESD type is LR 

The loader makes a translation table entry referring to the 
LR entry. 

CESD type is CM 

The loader sets the input address in the extended portion 
of the CM entry to zero, and makes a translation table 
entry referring to the CM entry. 

INPUT ENTRY TYPE IS PR: A PR entry can only be matched to 
another PR entry. When two of these definitions of external 
DSECT displacements have matching symbols, the loader sets the 
existing CESD entry to specify the greater of the two given 
displacement lengths. The loader also determines the most 
restrictive boundary alignment specified in the two PR entries. 
(For example, doubleword alignment is more restrictive than 
fullword.) The PR entry in the CESD is changed, if necessary, 
to specify this alignment. 


TEXT RECORD PROCESSING 

Text record processing consists of loading those CSECTs required 
for the loaded program into their assigned locations. The 
loader determines whether a CSECT is to be retained or deleted 
by examining the CESD entry for that CSECT's ID. The 
translation table is used to obtain the CESD entry. 

The way the loader processes text records depends on whether the 
current input is an object or a load module. If the input is an 
object module, the loader reads all the records for the module, 
including text, into virtual-storage buffer areas and then 
processes each record in turn. For load modules, the loader 
uses the information in the text control records to process the 
text before reading it into its assigned storage. 
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Processing Object Module Text (HEWLTXT) 

When a text record is recognized during processing of an object 
module# the ID contained in the record is translated into a CESD 
entry address. The loader translates the ID by first ensuring 
that the ID is valid# and then using the translation control 
table to obtain the corresponding translation table entry. 

The translation procedure is the same as used prior to 
allocating a translation table extent. (See "Making a 
Translation Table Entry.") 

In processing text# the loader considers an ID invalid if no 
translation table entry exists for it. Thus# an ID between the 
allowable limits of 1 and 1023 is invalid if it was not received 
during ESD processing. For any invalid ID# the loader issues an 
error message and then tries to process the next record. 

(Object module text processing is shown in "Diagram D7. Object 
Module Text Processing" on page 57.) 

(A) If a translation table entry does exist for an ID# the 
entry contains the address of the CESD entry for the related 
text. The loader determines whether the CESD entry is marked 
"delete." If it is# the loader skips the text record and tries 
to process the next record. 

(B) If the CESD entry is not marked "delete#" the loader sets 
an indicator to show that some text has been received for this 
module. If the "no length" indicator in the CESD entry has been 
set on# an indicator is set in the communication area to show 
that text has been received for a "no length" CSECT. The loader 
then calculates the address for this text in the loaded 
program's virtual-storage area. The address equals the 
displacement of the text from the beginning of the input# added 
to the relocation constant contained in the CESD entry. 

(C) Next# the loader checks whether the text would exceed 
available storage by adding the length of the text to the 
assigned virtual-storage address. The resulting end address for 
the text is compared to the overflow pointer—the beginning 
address of the loader tables (CMLOWTBL). If the text would 
overlap# loading is abnormally terminated. 

If there is sufficient unused storage for the text# the loader 
moves the text from the buffer area to the assigned address in 
the loaded program's area. Finally# the loader updates the 
pointer to the highest address used for the loaded program's 
text (CMLSTTXT). 


Processing Preloaded Text (HEWLMOD) 

If a SYSLIN data area consisting of internal object modules is 
passed to the loader# one MOD record may be substituted for all 
text records within a module. Upon encountering a MOD record# 
the loader checks that an internal object module is being 
processed# that no ESD records have been received for the 
module# and that some control information is contained in the 
MOD record. If any of these conditions is not met# the record 
is ignored. Otherwise# indicators are set to show that a MOD 
record and text have been received for the module. If the 
origin of the first CSECT is specified# it is saved in the 
communication area at location CMC0RE1. Similarly# the address 
of the byte following the estimated or actual end of the text is 
saved at location CMC0RE2. 

Extent information# used by the identification routine 
(HEWLIDEN)# is saved in chained entries pointed to by location 
CMXLCHN in the communication area. These entries contain the 
address and length of the extent# and a pointer to the next 
entry in the chain. The number of extents is saved at location 
CMNUMXS in the communication area. Later# the identification 
routine uses these entries to build a parameter list for the 
IDENTIFY macro instruction. 
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Finally# the address of the first extent is saved as the default 
entry point of the program if the entry point has not previously 
been defined* 


Processing Load Module Text CLMTXT) 

The loader uses the text control (or control/RLD) record to 
process load module text. The control record contains an 
ID/length list with an entry for each CSECT in the following 
text record. By processing the IDs consecutively# the loader 
determines which CSECTs from the record are to be retained as 
part of the loaded program. 

Load module text processing is shown in "Diagram D8. Load Module 
Text Processing" on page 58. 

PROCESSING THE ID/LENGTH LIST : The loader obtains each ID in 
turn from the list and attempts to translate each one# via the 
translation control and translation tables# to a CESD entry 
address. If the loader determines during translation that an ID 
is invalid# the loader skips over the record. If there are more 
records in the module# the loader continues processing the 
module. 

If the translation of the ID is successful# the loader checks 
for the "delete" flag in the CESD entry (obtained by the 
translation). If the entry is marked "delete#" the loader adds 
the length from the ID/length list entry to the sum of the 
lengths of any immediately preceding CSECTs to be deleted. 

The accumulated sum is used to truncate the text record when 
CSECTs at the end of the record are to be deleted. Therefore# 
only the sum of those consecutive CSECTs to be deleted at the 
end of the record is used. To accomplish this# the loader 
reinitializes the sum of these lengths to zero whenever a 
following CSECT is to be retained. (CSECTs to be deleted can be 
scattered throughout a text record.) 

If the CESD entry for a text ID is not marked "delete#" the 
loader determines whether the current CSECT is the first one to 
be retained from the text record. If it is# the loader saves 
the relative relocation constant from the related CESD entry. 
(After completely processing the ID/length list# the loader uses 
this relocation constant to calculate the proper main storage 
address for reading the text record.) After saving the 
relocation constant# the loader sets an indicator to show that 
at least one CSECT from this record is to be retained# and that 
its relocation constant has been saved. (Only one relocation 
constant per control record is used# because the text record is 
read in as a whole.) 

Each time the loader recognizes a CSECT to be retained# it 
updates the pointer to the last address used for text (CMLSTTXT) 
by adding the length of the CSECT to the previous value of 
CMLSTTXT. 

READING THE TEXT: After processing all IDs in the ID/length 

list# the loader prepares to read the text into 

storage—directly into the load program ! s storage area. The 

loader: 

• Adds the relocation constant and beginning delete length to 
the CCW address from the text control record to obtain the 
loader-assigned address of the text. (See Figure 17 on 
page 35.) 

• Subtracts the sum of the lengths of consecutive deleted 
CSECTs at the end of the text record from the text length in 
the control record to obtain the actual read count. 
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High Address 



CSECT 

CSECT 

CSECT ( 

A' 

B' 

_L__ 


Input Text Record 


Note: 

CSECT A* and CSECT B 1 are to be deleted. 

The text read address is, therefore, the Loader-assigned address of CSECT C. 

During later text processing, the Loader moves CSECT C to its proper location 
over CSECT A' and CSECT B\ 

Figure 17. Loading the Text from a Load Module Record 


• Adds the read count to the loader-assigned address to 
determine whether sufficient unused storage remains for the 
text. If not, an error message is issued and loading is 
terminated. 

• Determines whether the text record is the last record in the 
module by examining the control record's type. 

If the record is not the last, the loader determines whether any 
CSECTs from the record are to be deleted. If not, the text 
record and the following control record are read. (The control 
record is read into the RLD buffer.) 

If the text record is the last in the module, or if any CSECTs 
from the record are to be deleted, the loader reads in only the 
text record. If an end-of-file occurs, the loader terminates 
module-text processing and issues an error message; then the 
loader goes to end-of-module processing. 

CHECKING CSECT STORAGE ADDRESSESi If CSECTs to be deleted were 
scattered among the CSECTs to be retained, the loader deletes 
these scattered CSECTs after the text has been read into 
storage. 

The loader ensures that each CSECT is in the location determined 
during ESD processing. To do this, the loader again translates 
each ID in the ID/length list to obtain the related CESD entry. 

If a CESD entry for an ID is marked "delete," the loader 
continues translating successive IDs until one is not marked 
"delete." The loader determines whether the related CSECT is in 
the correct place by comparing its current address to the 
loader-assigned address found in the CESD entry. If the text is 
correctly placed, the loader continues to translate IDs. 
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If a CSECT is in the wrong place# the CSECT is moved to the 
loader-assigned address. Before checking the next ID in the 
ID/length list# the address of the current CSECT is updated by 
the length of the current CSECT to get the current address of 
the next CSECT. When all CSECTs are in the correct location# 
the loader continues processing the module with the next record. 

Next# the loader determines whether a control record was read at 
the same time as the text record. If so# the loader continues 
processing the module with that control record. Otherwise# the 
end of the module has been reached# and the loader goes to 
end-of-module processing. 


RELOCATION DICTIONARY (RLD) PROCESSING (HEWLRLD) 

Processing of relocation dictionary records consists of building 
the loader v s RLD table from information in the input RLD 
records. RLD record processing is the same for object and load 
module input. (Relocation of adcons is performed as the RLD is 
encountered# unless the referenced CSECT is not in virtual 
storage.) 

RLD record processing is shown in "Diagram D9. RLD Record 
Processing" on page 59. 

To build the RLD table# the loader tests the R and P pointers of 
the entries in an RLD record for validity. 16 These pointers 
consist of ESD IDs describing an address constant. The P 
pointer gives the ESD ID of the control section containing the 
address constant; the R pointer gives the ESD ID of the symbol 
referred to by the address constant. 

Because the pointers are IDs# they are valid if translation 
yields the address for the ID to a CESD entry. If an invalid ID 
is received# the loader issues an error message and continues 
RLD record processing with the next entry having different R and 
P pointers. 

The loader first translates the P pointer. If the CESD entry 
for that ID is marked "delete#" the loader skips all RLD entries 
with the same R and P pointers. If the CESD entry is not marked 
"delete." the loader checks the validity of the R pointer# 
unless the RLD entry is for a cumulative pseudo register (CXD 
type). 

(A) After ensuring that the RLD pointers are valid# the loader 
makes an RLD table entry for the input entry. (The loader uses 
the storage from a freed RLD entry# if possible. Otherwise# 
storage for the entry is obtained from the highest available 
storage.) 

The loader stores# in the RLD table entry# the loader-assigned 
address of the address constant. The address is obtained by 
adding the relocation constant from the CESD entry identified by 
the P pointer to the value found in the address field of the 
input RLD entry. (If the RLD is for a cumulative external DSECT 
displacement# it is chained from location CMCXDPT in the loader 
communication area; the next RLD entry is then processed.) The 
loader moves the flag field from the input entry to the RLD 
table. If the translation table entry indicates that an ER 
entry is referred to by the R pointer# the loader sets an 
indicator in the RLD table for absolute relocation. 


16 RLD entries for adcons referring to a cumulative pseudo 

register are only tested for a valid P pointer# because the 
R pointer is always zero (CXD-type RLD). 
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After completing the RLD table entry, the loader determines 
whether relocation is possible by determining the type of the 
CESD entry. Processing for the CESD entry types is as follows* 

SD, PC, LR 

The loader clears the chain field of the RLD table entry 
and relocates the address constant. (See "Relocating 
Address Constants.") 

CM, ER created from LR 

The loader delinks the RLD entry. That is, it subtracts 
the input address of the CM or ER from the value in the 
address constant. The RLD entry is then chained to the CM 
or ER entry for later relocation after the loader-assigned 
address is defined. 

PR, ER 

The RLD table entry is chained to the related CESD entry 
when the address for the CESD symbol is assigned. (See 
"Match Processing.") 

(B) After processing an RLD entry, the loader continues 
processing the entries in the RLD record until the end of the 
record is reached. If the R and P pointers for the next entry 
are the same as for the current entry, the loader does not 
recheck them for validity. Instead, the RLD table entry is made 
directly. If the pointers for the next entry are different, the 
loader performs the validity check. 


RELOCATING ADDRESS CONSTANTS (HEWLERTN) 

Address constant relocation is the replacement of an address 
constant in the text of the loaded program with the actual 
virtual-storage address. Whenever possible, the loader 
relocates adcons as it encounters their RLD entries. 

The loader processes three types of relocatable address 
constants: 

• A-type constants, used to reference a location in the same 
CSECT as the constant 

• V-type constants, used to reference a location in a 
different CSECT 

• Q-type constants, used to reference a displacement in an 
external dummy section 

In general, the virtual storage address equivalent of an address 
constant is calculated by combining either the relative or the 
absolute relocation constant with the input value of the address 
constant. 17 The relative relocation constant is the difference 
between the loader-assigned address and the input address of the 
referenced location. The absolute relocation constant is simply 
the loader-assigned virtual-storage address of the referenced 
location. Figure 18 on page 38 relates the types of relocation 
constants, and of address constants, to the types of relocation. 


17 The loader does not compute the absolute addresses for PRs 
or CMs until all the text has been loaded. 
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Type of 
Relocation 

Relocation Constant 
Usage 

Type of Address 
Constant 

Comments 

Absolute 

Relocation 

Absolute relocation 
constant replaces 
adcon value 

V(symbol) where 
symbol is not a 

PR in CESD 

Displacements are not valid 
in V-type address constants. 

Relative 

Relocation 

Relative relocation 
constant is added 
to or subtracted 
from adcon value 

A(symbol) where 
symbol is not an 
ER or PR in CESD 

Addition or subtraction is 
specified by indicators in 

RLD flag field. Also see 
comment below for Delinking. 

Relative 

Relocation 

Absolute relocation 
constant is added 
to or subtracted 
from adcon value 

A(symbol) where 
symbol is ER in 
CESD 

Addition or subtraction is 
specified by indicators in 

RLD flag field. 

Pseudo 

Register 

Relocation 

Pseudo register 
displacement 
constant is moved 
in 

Q(symbol) where 
symbol is PR in 
CESD 


Delinking 

Input address of CM 
or LR/LD CESD entry 
is subtracted from 
value 

A(symbol) where 
symbol is CM or 

ER created from 
LR/LD 

The relocation of address 
constants pointing to CM 

CESD entries is a 
combination of (1) delinking 
and subsequent (2) relative 
relocation with the absolute 
relocation constant. 


Figure 18. Relocation of Address Constants 


Note to Figure 18: 

Absolute relocation constant = loader-assigned address 
Relative relocation constant = loader-assigned address minus the 
input address 

When the loader resolves a CESD entry (for example# a CESD ER 
matched with an SD)# it relocates all address constants 
referring to the name. These are pointed to by RLD table 
entries chained from the CESD entry. The loader processes each 
RLD entry in the following way. 

First# the loader ensures that the address constant is not an 
invalid 2-byte adcon. (Two-byte adcons can only be used to 
define external DSECT displacements.) If the adcon is invalid# 
the loader issues an error message and continues loading the 
program. Otherwise# the loader moves the adcon from the text to 
a work area# where it determines the type of relocation 
required. 

If the RLD entry indicates absolute relocation# the loader 
places the absolute relocation constant at the text address. 

The RLD entry is placed on the chain of freed RLD table entries 
(CMRLDCHN)# and the next entry on the chain is processed. When 

the end of the RLD chain has been reached# the loader continues 

its processing. 

If the RLD entry indicates relative relocation# the loader also 
determines the type of relocation constant required. If the 
location referenced by the adcon is an external reference# the 
loader uses the absolute relocation constant. Otherwise# the 

loader uses the relative relocation constant. The loader tests 

the RLD entry to determine whether the relocation constant 
should be added to or subtracted from the input value of the 
address constant. After calculating the adcon value# the loader 
moves it back to the text. Finally# the loader frees the RLD 
entry and continues resolution. 
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If the RLD entry indicates delinking for a CM entry or for an LR 
entry converted to an ER# the loader subtracts the input address 
of common or of the LR from the value of the adcon. The result 
is a reference to a displacement in the common area or input 
module. Nhen these entries are resolved (that is# CM address 
assigned or ER matched)# absolute or relative relocation occurs. 

If the RLD entry indicates a PR reference# the loader performs 
absolute relocation as described above. 


END PROCESSING 


End processing includes END card processing for object module 
CSECTs# and end-of-module processing for object and load 
modules. 


END Card Processing 


The loader processes object module END cards for the length of 
the CSECT and for loaded program entry point definition. (Also# 
when an END card is recognized# the loader issues messages for 
any remaining LD entries for which no SD entry has been 
received.) In setting the length of the current CSECT# the 
loader determines whether the CSECT is a "no-length" CSECT. If 
it is# the loader uses the larger of the END card length and the 
length specified by the CESD SD entry as the CSECT length. 18 If 
the END card of a "no-length" CSECT does not specify a length# 
and text has been received for the CSECT# the loader issues an 
error message. (In this case# the length of the text is used.) 

The loader determines whether the loaded program's entry point 
name or address has already been received. If it has# the 
loader does not process the END card for entry point. If not# 
the loader examines the END card for an ID to be used for the 
entry point. If an ID is present# the loader sets the entry 
point address to the address specified by the END card# or to 0 
if the END card specifies no address. The loader translates the 
ID to a CESD entry address and saves the CESD address in 
location CMEPCESD. (If there is no CESD entry for the ID# an 
invalid-ID message is issued.) The loader creates an RLD entry 
for the entry point (at CMEPNAME). This entry is not treated as 
a regular RLD. 

If the END card does not specify an ID but does give a symbolic 
name to be used as the entry point# the loader saves the name at 
location CMEPNAME. If there is an SD or LR entry with that name 
in the CESD# the loader uses the address specified as the 
program entry point address. 


End-of-Module Processing 

At end of module for a load or object module# the loader 
initializes the next input module for processing. If text has 
been passed through text records# the loader updates the text 
pointers, CMLSTTXT and CMNXTTXT# by the module length or# if no 
length was given# to the address of the last text received 
(rounded to doubleword value). Then# the loader determines 
whether the available storage has been exceeded. If so# an 
error message is issued# and loading is terminated. Otherwise# 
the loader clears the translation table and the module length 
counter (CMMODLNG). All flags except the END and LIB flags are 
set off. The loader either begins processing another module 
from SYSLIN or# if end of file on SYSLIN is recognized# goes to 
process any secondary input; 


18 A "no-length" CSECT's SD can be matched by a CM entry# which 
defines an area larger than the CSECT. 
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SECONDARY INPUT PROCESSING CHEWACALL) 

After the loader has processed all primary input/ it attempts to 
resolve remaining ERs in the CESD if CALL was specified. If 
there are no remaining ERs> the loader performs final processing 
for the loaded program. (See n Final Processing for the Loaded 
Program.") 

The loader can resolve ERs from the link pack area and/or the 
SYSLIB data set. If the link pack area is available for 
resolution/ and the RES option is specified/ the loader searches 
the contents directory entry queue for the ERs before attempting 
to resolve them from SYSLIB. 

Secondary input processing is shown in "Diagram El. Secondary 
Input Processing" on page 60. 


RESOLVING ERS FROM THE LINK PACK AREA 

The loader obtains the address of the link pack area directory 
search routine from the communication vector table (CVT). It 
then searches the ER chain for an ER that is not marked "never 
call" or "weak call." (A) When one is found/ the name in the ER 
is passed to the LPA directory search routine. If the directory 
search routine does not find a match for the name/ the loader 
searches for the next ER that is not marked "never call" or 
"weak call." 

If the directory search routine finds a match for the name/ the 
loader puts the entry point in the CESD entry and changes the 
entry's type to SD. The loader then takes the entry off the ER 
chain/ puts it on the SD chain/ and makes a map entry for the SD 
if MAP is specified. Finally/ the loader relocates all RLD 
table entries that are chained to the CESD entry. 

The loader then searches for the next ER that is not marked 
"never call" or "weak call." 

This search is repeated until the entire ER chain has been 
processed. 

If there are still unresolved ERs after resolution from the link 
pack area/ the loader performs library call processing. 
Otherwise/ the loader performs final processing for the loaded 
program. (See "Final Processing for the Loaded Program.") 


RESOLVING ERS FROM THE SYSLIB DATA SET 

Before resolving ERs from the SYSLIB data set/ the loader checks 
whether an open SYSLIB data set has been passed. (The fourth 
entry in the DCB list/ which is passed to the loader as a 
parameter/ can point to an open SYSLIB DCB.) If an open SYSLIB 
DCB has been passed to the loader/ the exit addresses in the 
passed SYSLIB DCB are saved in the communication area and 
replaced by the loader's own exit routine addresses. If a 
SYSLIB DCB has not been passed/ a SYSLIB DCB is initialized and 
opened. 19 

(B) Otherwise/ the loader constructs two lists used for BLDL 
information in the available storage. The available storage is 
defined by CMLOHTBL (the lowest address used by the loader 
tables and buffers) and CMLSTTXT (the highest address used by 
the loaded program's text). The two lists are the BLDL list and 
an address list. The loader uses the address list to store 
pointers to the ER entries in the CESD for which it constructs 
BLDL entries. The entries in the two lists have a one-to-one 


19 If the loader has opened a SYSLIN data set/ the loader 
closes it before opening SYSLIB and reuses the DCB for 
SYSLIB. 
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correspondence relative to the ER entries. Figure 19 on page 42 
shows this relationship. 

Before constructing the lists* the loader determines the maximum 
number of entries possible by dividing the amount of available 
storage by the number of bytes required for an entry in the two 
lists (BLDL list entry size = 16* address list entry size = 4). 

Then* for each ER that is not marked "never call" or "weak 
call*" the loader makes an entry in the BLDL list* including the 
name specified by the ER and the address of the ER. 

After building the BLDL list* the loader constructs the address 
list by moving the pointers to the ERs from the BLDL list. This 
preserves the pointers* which are overlaid in the BLDL list 
during BLDL operation. 

Finally* the loader issues the BLDL macro instruction. If an 
I/O error occurs during execution of the BLDL* the loader logs 
the error and performs final processing for the loaded program. 

(C) Otherwise* the loader moves the relative track addresses 
(TTRs) returned in the BLDL list to the associated CESD entries. 
Each CESD entry for which a TTR was returned is marked to 
indicate that it contains an auxiliary storage address. 

The loader issues a FIND macro instruction for each ER entry 
marked "TTR received•" The loader processes each module located 
in the same way as it processes primary input modules. 

Because SYSLIB contains only load modules or only object 
modules* processing for each module located is the same. If 
SYSLIB contains object modules* the loader first primes the 
buffers and then performs object module processing. If SYSLIB 
contains load modules* the loader performs load module 
processing. See "Primary Input Processing." 

The loader resolves as many ERs from SYSLIB as possible. It 
then performs final processing for the loaded program. (If 
during processing of one or these modules a program size error 
occurs* the loading procedure is terminated with an error 
message.) 


FINAL PROCESSING FOR THE LOADED PROGRAM 

After all possible ERs have been resolved* the loader performs 

the following for the loaded programs 

• Assigns addresses for common areas 

• Assigns addresses for displacement in the external DSECT 
(pseudo registers) 

• Issues messages for all unresolved ERs 

• Finds the address of the program's entry point 

• Builds a condensed symbol table if the loader is operating 
in time-sharing mode 

• Identifies the loaded program to the system* unless the 
processing portion of the loader was directly invoked by the 
name HEWLOADR 

• Writes out the diagnostic message dictionary 
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ASSIGNING ADDRESSES FOR COMMON AREAS (COMMON) 

The loader assigns addresses for the loaded program's common 
areas by processing entries on the CESD CM chain. 

For each CM entry, the loader assigns the next available storage 
address above the text of the loaded program. (The highest text 
address before the allocation of a common area is saved in the 
communication area at CMTOPCOD. This allows the loader to 
continue using work space that may be overlapped with common 
areas. The address contained in CMNXTTXT rounded to doubleword 
value is the address used. The loader ensures that there is 
enough available storage for the common area, and then updates 
the pointer to available storage by adding the length from the 
current common entry to the CMNXTTXT value. (If there is not 
enough storage, an error message is issued and loading is 
terminated.) Next, if the MAP option was chosen, the common 
area is mapped. Finally, the loader relocates the address 
constants referring to the current "common" definition. (The 
adcons are relocated through processing the RLDs chained from 
the current CESD CM entry.) 

After all the CM entries in the CESD have been processed, the 
loader assigns addresses for external DSECT displacements. 


ASSIGNING ADDRESSES FOR EXTERNAL DSECT DISPLACEMENTS (PSEUDOR) 

The loader assigns contiguous storage for displacements in the 
loaded program's external DSECT by processing the CESD PR chain. 
(The storage for all DSECTs is obtained via one GETMAIN macro 
instruction, and the individual DSECTs are displacements within 
the area.) 

For each entry on the chain, the loader subtracts the alignment 
factor from hexadecimal "FFFF". The loader adds the difference 
to the location counter for the PRs to obtain the assigned 
address of the current external DSECT. (The location counter is 
0 at the beginning of PR processing.) After calculating the 



ERNAME1 

i 

i CESD entry 
for ERNAME1 

ERNAME2 

i 

i CESD entry 
for ERNAME2 

ERNAME3 

i 

k CESD entry 
for ERNAME3 


BLDL List 


• BLDL List and Address List before BLDL 
macro instruction is issued. 

• After execution of the BLDL, the BLDL List 
contains TTRs for library-resolved ERs. 


Figure 19. BLDL List and Address List 


A CESD entry 
T for ERNAME1 


A CESD entry 
* for ERNAME2 


A CESD entry 
T for ERNAME3 


Address List 
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current address, the loader updates the location counter by 
adding the length of the displacement specified in the CESD PR. 
Then the loader maps the DSECT displacement and relocates all 
address constants referring to it. These are indicated by RLD 
table entries chained to the PR entry. 

After processing all the PR entries, the loader stores the value 
contained in the location counter (the cumulative length of all 
DSECTs) in all locations in the loaded program requesting it. 
These locations are chained from CMCXDPT in the communication 
area. 20 (If NCAL was specified, there is no CXD chain pointer 
in CMCXDPT.) 


ISSUING UNRESOLVED ER MESSAGES 

For all ERs remaining in the CESD that are not marked "weak 
call, 11 the loader issues either error or warning messages. If 
NCAL is specified, or if an ER is marked "never call," the 
loader issues a warning message. Otherwise, an error message is 
issued. An error message is also issued if no text was loaded 
for the program. 


CHECKING THE LOADED PROGRAM'S ENTRY POINT 

After the loaded program has been processed, the loader checks 
to determine whether the entry point name and address have been 
received. This is determined by testing the program flag field 
(CMPRMFLG). Processing for the possible conditions is as 
follows* 

• Entry point name and address both received. No further 
entry point processing is required. 

• Only entry point name received. If the entry point name was 
specified by the EP= parameter but no address for the name 
was received, the loader issues an error message. Then, if 
text for the SYSLIN data set was pointed to by MOD records 
instead of being passed through text records, the address of 
the first byte of the first extent described on a MOD record 
is assigned as the entry point. Otherwise, the loader 
assigns the address of the first byte of loader-constructed 
text (found in CMBEGADR) as the entry point. 

• Only entry point address received. If the entry point 
address was received (CMEPADDR), the loader determines 
whether the referenced symbol is an ER. If so, the loader 
assigns the first byte of text as the entry point. 

• Neither entry point nor address received. The loader issues 
an error message and uses the first byte of text as the 
entry point. 

After determining the entry point for the loaded program, the 
loader calculates the program's total length. The length equals 
the difference between the address of the next available storage 
(CMNXTTXT) and the address of the first byte of text (CMBEGADR) 
added to the lengths of any extents that may be passed through 
MOD records. The loader then prints out the entry point address 
and the total length of the loaded program. 


20 See Ass_embler language for the use of external DSECTs and 
the CXD statement. 
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IPEMTIFYXNGTHE_LQAPEP PROGRAM 

If program loading is successful/ the loader prepares to 
identify the program to the control system. 21 A parameter list 
is constructed to pass the program name/ addressing mode, entry 
point address/ and extent list information to the IDENTIFY macro 
instruction. (The extent list defines the storage that the 
loaded program occupies.) If storage is not available for this 
parameter list/ an error message is issued and loader processing 
is terminated. 

The loader initializes the parameter list with the program name/ 
addressing mode, entry point address/ and length and address of 
the loadei—constructed program (as the first extent). This 
information is found in the communication area. If the loader 
is operating in time-sharing mode/ it attempts to build a 
condensed symbol table for use during the program v s execution. 

An entry is made in the table for each control section and 
common area in the program. This table becomes the second 
extent of the program/ and its address and length are placed in 
the extent list. If there is not enough storage for the entire 
table/ it is not built/ and the second extent of the program is 
assigned a length of zero. The extent list is then completed 
with the extent information that was passed on MOD records and 
saved in the communication area. 

Finally/ the.IDENTIFY macro instruction is issued. If 
identification processing is not successful/ an error message is 
issued and loader processing is terminated. Otherwise/ a flag 
indicating that the program has been identified is set in the 
communication area. 


H jjD_QE_ Lp ADJNS 


After all processing for the loaded program is complete/ the 
loader processing portion performs termination processing and 
then passes control to the loader control portion. The control 
portion then attempts to execute the loaded program. 


LOADER PROCESSING TERMINATZON 

If the SYSLOUT and/or SYSTERM data set was opened/ the loader 
prints a diagnostic dictionary describing the errors encountered 
during loading. (As errors occur/ the loader sets a flag 
indicating the type of error in the bit map field (CMBITMAP) in 
the communication area.) The loader determines the highest 
error severity indicated and returns it to the caller at 
termination. 

Next the loader ensures that all diagnostic data has been 
Written to SYSLOUT/ and then closes both the output and the 
current input data sets. 22 

The loader then sets up the return parameter list. If the 
processing portion of the loader was invoked through the entry 
point HEWLOAD/ the name of the identified program is placed in 
this parameter list. Otherwise/ the list contains the virtual 
storage address and size of the loaded program. 


21 This processing is performed only when the processing 
portion of the loader is invoked/ either directly or by the 
control portion of the loader/ by the name HEMLOAD. 

22 The current input data set is SYSLIB unless no library 
searching was done. The loader closes SYSLIN when it opens 
SYSLIB. However/ if a SYSLIB DCB marked open was passed to 
the loader/ SYSLIB is not closed. 


44 MVS/370 Loader Logic 


LY26-3922-1 © Copyright IBM Corp. 1972/ 1985 



Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


Finally, the loader issues a FREEMAIN macro instruction for all 
its processing storage not assigned to the loaded program or to 
the condensed symbol table. (If the completion code for loading 
is greater than 4, the storage occupied by the loaded program is 
also released, including preloaded text passed through MOD 
records. If the loaded program was identified, the storage it 
occupied is released through the execution of the LOAD and 
DELETE macro instructions.) The loader then returns control to 
the control portion. 


LOADER CONTROL TERMINATION 

Before attempting to execute the loaded program, the loader 
control portion issues a DELETE macro instruction for the 
processing portion. Then, if the condition code for loading is 
not greater than 4, the loader control portion, through the 
execution of an ATTACH macro instruction, passes the user's 
parameter list to the loaded program for its execution. 

After the program's execution, the loader control portion issues 
a DELETE macro instruction for the loaded program, frees its 
processing storage, and returns to the scheduler. 
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The following diagrams show the flow of data through the loader# 
and are used with the descriptions given previously in this 
section to give an integrated picture of the loader logic. Each 
diagram has an alphameric identification (for example# Al). 
Within each diagram/ specific points of reference have 
alphabetic labels. When the description at the beginning of this 
section discusses a function# it refers to the operation diagram 
as a whole# and to the specific labeled references where 
appropriate. For example# the description of initialization 
refers to Diagram Bl. Within the discussion# reference (B) 
refers to point (B) in Diagram Bl. 

The symbols used in the diagrams are shown in the following 
chart. 
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LOADER PROCESSING STORAGE 



52 
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Notes : 

1. Module HEWLOADR is deleted after its execution 
and before the loaded program is given control. 

2. Load module text is read directly into the loaded 
program area. 

3. A hex *80’ in the high-order byte of a fullword 
signifies that it is the last field in the parameter list. 
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{ SYSIN DD 

f SYSUBDD 

( SYSLOUT DD 

Y 

f SYSLIN DD 


J 

'logo EXEC 
PGM=LOADER 
PARM=‘MAP,LET/X,Y' 




or 

through issuing a LOAD, 
XCTL, LINK, or ATTACH 
macro instruction referring 
to HEWLDRGO (program 
name) or to LOADER (alias). 
Parameters are passed via 
list addressed by Reg ^ 1 

I NOTE l| 


Scheduler 



XCTL 


Jewldrgo 
^HEwLOADR A 




Parameter list 


CSECT HEWLCTRL 


Entry point HEWLDRGO 


VIRTUAL STORAGE 


to 

Diagram B1 


SYS 1 . LINKLIB 


NOTE 1 


The user may invoke the Loader to load a program 
but not pass control to it. In this case, the user 
issues a LOAD and a CALL macro instruction 
referring to HEWLOADR (for loading without 
identification) or to HEWLOAD (for loading with 
identification). 


48 MVS/370 Loader Logic 


LY26-3922-1 © Copyright IBM Corp. 1972, 1985 





Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 

DIAGRAM Bl. LOADER/SCHEDULER INTERFACE AMD INITIALIZATION 


■ength USEil OPTIONS 

of options_ 


USER DDNAMES 


PARAMETER 

LIST 


— 


00 


— 

USER DCBs 


Builds INITMAIN from 
control tnformotion cnolyzed 


CSECT 

hewlctrl 


<2£wloaoR 


SYS1. LINK LIB 


LOAD'CALL 

HEWLOADR, entry point- 
HEWUOCA, qlias-HEWlQ AD 

f CSECT _, 

HEWLDDEF 

__^ HEWI 

■Mk csect mm 

HEWUOCA 


CSECT 

HEWIRELO 


HEWLCTRL chonge* the length 
of the option list received from 
the scheduler to the length of 
the Loader options only. 


CSECT 

HEWLUBP 


CSECT 

hewuden 


GETMAIN 
(Note 1 > 


Save area 

See Mote 2 

Ddnon-.es 

Entry point name 

Parameter flags 

DCB addresses 

Storage 

Minimum storage 

Maximum storage 

request size 

request size 

GETMAIN ti« 

Conversion area 

Option translation 

Rejected options 

table 

buffer 


1. Establishes 

HEWLOCOM 

2. Allocates and 
chains scve 
areas 

3. Issues o 
FREEMAIN for 
the INITMAIN 
orea 


Looder Processing Storage 


loader Communication Area 


Save Areo 1 
Save Area 2 
Save Area 3 


Notes 

1 . HEWUOCA issues a GETMAIN for the size range 

specified by the SIZE parameter (stored in INITRMAX) 
and the vofue specified by the INITRMIN field. 

2. The size end address of the looder processing area 
ere inserted by the GETMAIN SVC handler. 

3 • A DCB is constructed for the output data set if 
the PRINT option was chosen. A DCB is olio cons¬ 
tructed for the input date set if a SYSLIN control 
block, which describes cm internal data area,was 
not passed. A DCB, two DECBs, end two buffers ore 
provided for tho terminal data set If the TERM 
option was chosen. 


Conslrucis 0C8s lor data \ | 

sets (Note 3) and allocates output bulfers r • 13 


OPEN for OPENLIST 


> Diagram Cl 


Scve Areo 8 
Scve Areo 9 

SYSTERM DCB, OECBs 
and Buffers _ 

SYSUN DCB 
SYSLOUT DCB 
SYSLOUT Buffers 

Prime Storage 


Diagram El 
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DIAGRAM Cl. PRIMARY INPUT CONTROL AND BUFFER ALLOCATION 


HEWLIOCA 



from initiali¬ 
zation or 
primary input 
processing 


HEWBUFFR 
Buffer alloca- 
indicate unlike | tion routine 
attributes in 
input DCB 


R * 10 


Input Data Set 



Diagram D1 


if DECB1 "TBM^DiagramD2 

DECB 2 

V 

♦ 

RLD buffer (256 bytes) 



Loader Processing Storage 
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DIAGRAM Dl. OBJECT MODULE PROCESSING 



RETURN 
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Finish 
proces¬ 
sing 
module 
or return 
to caller 
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DIAGRAM D3. ESD RECORD PROCESSING (GENERALIZED) 


R # 4 


Object Module Buffer or RLO Buffer 


1st 10 
in data 


ESD/CESD data 



NAME 

i 

•; ADDR ADDR 

( 




Input 


R # 7 


Length 
of data 



Information moved 
depends on entry type 

<D 


Do any preliminary 
processing needed. _ Non-resolution. 
Search CESD. JD Moke CESD entry . 



After processing all input 
entries in data, return 


Translation Table extent 


Note: ESD processing differs according to entry type 
and whether resolution is possible. For detailed information, 
refer to "External Symbol Dictionary Processing". The following 
diagrams give some examples of processing for different conditions. 
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DIAGRAM D4. EXAMPLE OF INPUT ESD PROCESSING OF SD-SECTION DEFINITION (HEMLESD) 


Input ESD entry; ESD ID - 3 
CSECTA SD ln f > , ut Lena 


Uses entry’s 
type and name to 
CE5DSRCH search type chains 

Diagram Cl 
Diagram D2 


The input address is 
used to calculate the 
Loader-assigned address 
and the relative relocation. 


CMTYPCHN 


MATCH 

sEXISTS 


NOMATCH — 
Makes a CE5D entry, 
chains it and makes 
a translation table 
entry for if. 




Translation Table Extent 


t T t 

0 CSECTA SD 

Loader- 

assigned 

address 

relative 

reloca¬ 

tion 

constant 


CESD entry 


This example shows processing for an input SD entry when 
This example returns to the caller 


MATCHED / 1 

Changes the existing LX 

ER to SD, rechains r“ 

the entry and makes T$D 

chain 

entry for the input V 

entry referring to the _ . . 

. ' 4 Existim 

existing entry __ 

Mj no match exists in the CESD (nonresol 

(2^ a match exists (resolution processing) 


Translation Table Extent 


it __ 

fsD 

chain 

CSECTA 

SD 

Loader- 

assigned 

address 

re lative 
reloca¬ 
tion 

constant 


Existing CESD entry 
onresoluiion processing) 


process 
next ESD 
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DIAGRAM D5. EXAMPLE OF INPUT ESD OF ER-EXTERNAL REFERENCE PROCESSING (HEMLESD) 


Input ESD entry ESD ID - 2 


CMTYPCHN 


NAME ER 0 


SD LD ER 


Translation 
Table Extent 


Note 1 . The high bit of 
the first byte is 
^ set on to show 

CESD entry is 
for ER. 


Uses entry's 

type and name 

to search type chains 


Diagram Cl 
Diagram D2 

CMTYPCHN 


SD LD ER LR/CM 


MATCH EXISTS, 


(T) NOMATCH 
W make CESD 
entry, chain 
entry, and 
^ make transla¬ 
tion table 
entry 


MATCHED — 
make translation 
table entry to 
existing CESD 
entry 


0 NAME ER 0 


CESD entry for ER 




Go to process 
next ESD entry 


^ Go to process 
next ESD 
entry 


NAME CM 


This example shows processing for an input ER entry when (T) no match in the CESD exists (non resolution processing) 

( 2 ) a match exists (resolution processing) 
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DIAGRAM 06. EXAMPLE OP ESD ID TRANSLATION 


CMTYPCHN 


Input CESO entry 



Notes : 

1. Input LR entry contain* 
the ESD ID for CSECT 
containing NAME. 

2. Only for object module 
input, the input LD is 
placed on temporary 
chain. 


0 

1 

2 

/ 

/ 

> 

3 fCESD entry 


-w ** 


Translation Table Extent 


This example shows preliminary processing ol an input LR. Translation ensures 
the input ID is valid and obtains the CESD address of the related SD. 
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DIAGRAM D7. OBJECT MODULE TEXT PROCESSING 



HEWLTXT 

from HEWLRELO 


Move text to assigned 
address; Update storage 
pointer if needed 

Return 



Return, to 
read the next 
record 


HEWERROR 

to end loading 
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DIAGRAM D8. LOAD MODULE TEXT PROCESSING 



1. Read text record, unless the record Is 
to be skipped; read the following control 
record also, unless the text record Is the 
last or CSECTs are to be deleted. 

2 See Figure 19. 
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DIAGRAM D9. RLD RECORD PROCESSING 



Note 1 : The input buffer is the RLD buffer (load module) or an object module buffer* » 

Note 2: The Loader calculates the adcon address using the P-pointer CESD entry's relocation constant and the I Adcon and flags from the 
input RLD entry* The flags are inserted in the new RLD entry unless the input RLD is for o CXD PR. 

Note 3: If the type in the CESD entry for the address constant is PC, SD, or LR relocation is performed. If the type is CM, PR, or ER, the 
RLD entry is chained to the CESD entry. * 
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ORGANIZATION OF THE LOADER 


Figure 20 shows the organization of the loader. The flow of 
control through the first four levels of the processing portion 
of the loader (module HEW10ADR) is listed in the control level 
tables below. 



Note: The CSECT containing the code of a function is noted outside 
the functional block. 

Figure 20. Loader Organization 
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ROUTINE CONTROL-LEVEL TABLES 


The routine descriptions within a level are listed 
alphabetically in Figure 21 through Figure 24. 


Routine 

Purpose 

Called 

Routines 

Calling Conditions 

HEWLIOCA 

Initialization, primary 
input control, and 
allocation processing 

HEWLPRNT 

Called if SYSLOUT data set is 
open 



HEWBUFFR 

If more data exists on SYSLIN 



HEWPRIME 

If SYSLIN input is an object 
module 



HENLRELO 

If SYSLIN input is an object 
module 



HEWLODE 

If SYSLIN input is a load module 



HEWACALL 

When all SYSLIN input is 
processed, unless SYSLIN did not 
open 



HEWLIDEN 

If the loaded program is to be 
identified to the control program 



HEWBTMAP 

Input processing completed 

Figure 21. 

HEWLOADR—Level 1 




Routine 

Purpose 

Called 

Routines 

Calling Conditions 

HENACALL 

Secondary input and 
final processing 

HEWOPNLB 

If ERs cannot be resolved from 
primary input or the LPA 



COMMON 

Always 



HEWLMAP 

If an ER is resolved 



HEWLERTN 

If an ER is resolved 



HEWERROR 

If an error occurs 



HENPRIME 

If SYSLIB input is object modules 



HENLRELO 

If SYSLIB input is object modules 



HENLODE 

If SYSLIB input is load modules 

HEWBTMAP 

Processing of error-bit 
map and printing of 
diagnostic dictionary 

HEWLPRNT 

If SYSLOUT is open and messages 
are required 



HENTERM 

If the TERM option is specified 
and messages are required 


Figure 22 (Part 1 of 2). HEWLOADR—Level 2 
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Routine 

Purpose 

Called 

Routines 

Calling Conditions 

HEWBUFFR 

Buffer Management 

FREECORE 

If previous or current (not the 
first) allocation is for object 
module 



GETCORE 

If no previously allocated area 
is large enough for current 
request 

HEWLIDEN 

Identification of the 
loaded program to the 
control program 

IDENTER 

Always* unless extents will 
overlap loader work space 



IDMINI 

Always* unless extents will 
overlap loader work space 



HEWERROR 

If an error occurs 

HEWLODE 

Process a load module 

HEWLREAD 

Always 



HEWLEND 

If end-of-module is indicated 



HEWLESD 

If CESD record is received 



HEWLRLD 

If RLD record is received 



LMTXT 

If TXT record is read in 

HEWLPRNT 

Print output to SYSLOUT 
data set 

RDCHECK 

If DECB was previously written 



WTWRITE 

Always 



WTCHECK 

Always 

HEWLRELO 

Process an object module 

HEWLREAD 

Always 



HEWLEND 

If END card received 



HEWLESD 

If ESD card received 



HEWLRLD 

If RLD card received 



HEWLTXT 

If TXT card received 



HEWLMOD 

If MOD card received 

HEWPRIME 

Read records into all 
but one buffer before 
HEWLRELO receives 
control 

RDREAD 

Always 

Figure 22 

(Part 2 of 2). HEWLOADR— 

Level 2 
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Routine 

Purpose 

Called 

Routines 

Calling Conditions 

COMMON 

Assign addresses to 

PSEUDOR 

Always 


common areas 

HENLMAP 

Always , unless no CM entries were 
received 



HENLERTN 

Always^ unless no CM entries were 
received 

FREECORE 

Chain deallocated area 
to free list 

none 


GETCORE 

Allocated storage for 
allocation request 

HEMERROR 

If table overflow occurs 

IDENTER 

Create entry in extent 
list 

none 


IDMINI 

Create a condensed 
symbol table 

none 


HEMERROR 

Handle error messages, 
severity code 4 errors 

HEHLPRNT 

If SYSLOUT data set is open 



HEHTERM 

If the TERM option is specified 

HEMLCNVT 

Convert binary quantity 
to hexadecimal 

none 


HEHLEND 

Process END card, 
reinitialize for next 
module 

TRANSID 

If END card specifies entry point 
address 



HEMERROR 

If error occurs in end card 




processing 

HEMLERTN 

Relocate all adcons 
indicated by RLD chain 

HEMERROR 

Invalid 2-byte adcon 

HEHLESO 

Create CESD from input 
ESD/CESD 

LOADPROC 

If input is a load module 



CESDSRCH 

Input entry is not NULL or PC 



TRANSLAT 

If NULL entry is made 

• 


CESDENT 

If PC or LR entry is required 



ENTER 

If PC entry is required 



CKECKEP 

If PC entry is required 



MATERSD2 

If PC entry is required 



TRANSID 

If LD/LR is received 

HENLMAP 

Create map entry for 
referenced location in 

HEMLPRNT 

IEHLCNVT 

Always 

Always 


loaded program 

Figure 23 (Part 1 of 3). HEMLOADR—Level 3 
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Routine 

Purpose 

Called 

Routines 

Calling Conditions 

HEMLMOD 

Process MOD card/ store 
text origin/ length/ and 
extent information 

ALLOCATE 

If extent information is passed 
on MOD card 

HEWLODE 

Process a load module 

HEMLREAD 

Always 



HENLEND 

If end-of-module is indicated 



HENLESD 

If ESD record is read in 



HEMLRLD 

If RLD record is read in 



LMTXT 

If TXT record is read in 

HEWLPRNT 

Print output to SYSLOUT 
data set 

RDCHECK 

If DECB was previously written 



MTWRITE 

Always 



MTCHECK 

Always 

HEMLREAD 

Handle request for data 

RDREAD 

Always 



RDCHECK 

Always 

HEWLRELO 

Process an object module 

HEMLREAD 

Always 



HEHLEND 

If END card is received 



HENLESD 

IF ESD card is received 



HEMLRLD 

If RLD card is received 



HEMLTXT 

If TXT card is received 

HEWLRLD 

Relocate adcons 
indicated by RLD entries 
received/ or chain RLDs 
off CESD entry for R 
pointer 

TRANSID 

ALLOCATE 

Always 

If no free RLD entry is available 



HEMLERTN 

If relocation is possible/ or if 
delinking required 

HEWLTXT 

Move object module text 
to correct space 

TRANSID 

RELOREAD 

Always 

Always 



HEMERROR 

If invalid ID received 

HEMOPNLD 

Open SYSLIB; close 

SYSLIN 

HENBUFFR 

Unless SYSLIB was not opened 

HEMPRIME 

Read records into all 
but one buffer before 
HEHLRELO receives 
control 

RDREAD 

Always 

HENTERM 

Print output to SYSTERM 
data set 

NTNRITE 

Always 



MTCHECK 

Always 


Figure 23 (Part 2 of 3). HEMLOADR—Level 3 
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Routine 

Purpose 

Called 

Routines 

Calling Conditions 

LMTXT 

Read load module text 
into main storage 

TRANSID 

Always 



HEWLREAD 

Unless record is to be skipped 



HENERROR 

If text record not received 



PROCEOM 

Always 

RDCHECK 

Check DECB 

none 


RDREAD 

Read input using DECB 
information 

none 


WTCHECK 

Check DECB 

none 


WTWRITE 

Write output using DECB 
information 

none 


Figure 23 

(Part 3 of 3). HENLOADR— 

-Level 3 
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Routine 

Purpose 

Called 

Routines 

Calling Conditions 

ALLOCATE 

Allocate table extent 

HEMERROR 

Table overflow 

CESDENT 

Get CESD entry form free 
entry list or# call 
ALLOCATE to obtain an 
entry 

ALLOCATE 

No free entries on list 

CESDSRCH 

Search CESD for input 
name 

MATCHED 

If name is found 



NOMATCH 

If name is not found 

CHECKEP 

Check CESD entry for 
specified entry point 

none 


ENTER 

Enter information in 

CESD entry for PC or SD 

HEMERROR 

If program is too large 

HENBUFFR 

Buffer management 

FREECORE 

If previous or current (not the 
first) allocation request is for 
object module 



6ETC0RE 

If no previously allocated area 
is large enough for current 
request 

HEMERROR 

Handles error messages# 
severity code 4 errors 

HEMLPRNT 

If SYSLOUT data set is open 



HEMTERM 

If the TERN option is specified 

HEWLCNVT 

Convert binary quantity 
to hexadecimal 

none 


HEWLEND 

Process END card# 
reinitialize for next 
module 

TRANSID 

If END card specifies entry point 
address 



HEMERROR 

If error occurs in END card 
processing 

HEWLERTN 

Relocate all adcons 
indicated by RLD chain 

HEMERROR 

Invalid 2-byte adcon; invalid 
3-byte adcon 

HEWLESD 

Create CESD from input 
ESD/CESD 

LOADPROC 

If input is a load module 



CESDSRCH 

Input entry is not NULL or PC 



TRANSLAT 

If NULL entry is made 



CESDENT 

If PC or LR entry is required 



ENTER 

If PC entry is required 



CHECKEP 

If PC entry is required 



MATERSD2 

If PC entry is required 



TRANSID 

If LD/LR is received 


Figure 24 (Part 1 of 3). HEWLOADR—Level 4 
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Called 


Routine 

Purpose 

Routines 

Calling Conditions 

HEMLMAP 

Create map entry for 

HEWLPRNT 

Always 


referenced location in 
loaded program 

HEWLCVNT 

Always 

HEHLPRNT 

Print output to SYSLOUT 
data set 

RDCHECK 

If DECB was previously written 



WRWRITE 

Always 



WTCHECK 

Always 

HEWLREAD 

Handle request for data 

RDREAD 

Always 



RDCHECK 

Always 

HEWLRLD 

Relocate adcons 
indicated by RLD entries 
received* or chain RLDs 
off CESD entry for R 

TRANSID 

Always 


pointer 

ALLOCATE 

If no free RLD entry is available 



HEWLERTN 

If relocation is possible* or if 
delinking is required 

HEWLTXT 

Move object module text 

TRANSID 

Always 


to correct spaces 

RELOREAD 

Always 



HEWERROR 

If invalid ID is received 

HEWTERM 

Print output to SYSTERM 
data set 

WTWRITE 

Always 



WTCHECK 

Always 

LMTXT 

Read load module text 
into virtual 

TRANSID 

Always 



HEWLREAD 

Unless record is to be skipped 



HEWERROR 

If text record not received 



PR0CE0M 

Always 

L0ADPR0C 

Preliminary processing 
for load module CESD 

CESDENT 

If entry type is PC*SD*LR 

MATERSD2 

Test length and request 
map entry 

CHAINING 

Always 

PR0CE0M 

Go to process 
end-of-modu1e 

HEWLEND 

Always 

PSEUDOR 

Assign displacements to 

HEWLPRNT 

If displacement is assigned 


pseudo registers 

FINISHUP 

Always 



HEWLMAP 

If displacement is assigned 



HEWLERTN 

If displacement is assigned 


Figure 24 (Part 2 of 3). HEWLOADR—Level 4 
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Routine 

Purpose 

Called 

Routines 

calling conditions 

RDCHECK 

Cheek DECB 

none 


RDREAD 

Read input using DECB 
information 

none 


RELOREAD 

Go to HEHLREAD for more 
input 

HEWLREAD 

Always 

TRANSID 

Translate input ESD ID 
to CESD address 

ALLOCATE 

If new extent is required 



HEWERROR 

If table overflow or invalid ID 
occurs 

TRANSLAT 

Make a translation table 
entry 

TRANSID 

Unless LD entry 

WTCHECK 

Check DECB 

none 


WTWRITE 

Write output using DECB 
information 

none 



Figure 24 (Part 3 of 3). HEWLOADR—Level 4 
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MICROFICHE DIRECTORY 


The microfiche directory is designed to help you find named 
areas of code in the program listing, which is contained on 
microfiche cards at your installation. Microfiche cards are 
filed in alphameric order by object module name. If you wish to 
locate a control section, entry point, table, or routine on 
microfiche, find the name in the first column and note the 
associated object module name. You can then find the item on 
microfiche. 


Name 

Description 

Object Module 

CSECT 

Synopsis 

ALLOCATE 

Allocation 

Routine 

HEMLDREL 

HEHLRELO 

Allocates storage for 
table entries 

CMTRCTRL 

Table 

HEWLDREL 

HEHLRELO 

Pointers to 
translation table 
extents 

CMTYPCHN 

Table 

HEMLDREL 

HENLRELO 

Pointers to CESD type 
chains 

COMMON 

Label 

HEMLDLIB 

HEMLLIBR 

Assigns addresses to 
common 

DECB 

DSECT 

HEMLDIOC 

HEMLIOCA 

Model DECB 

ERCODES 

DSECT 

HEMLDIOC 

HEMLDREL 

HEMLDLIB 

HEMLIOCA 

HENLRELO 

HEMLLIBR 

Error code definitions 

FINISHUP 

Label 

HEMLDLIB 

HEMLLIBR 

Prints finishing 
messages 

HEHACALL 

Entry point 

HEMLDLIB 

HEMLLIBR 

Automatic library call 
processing 

HEWBTMAP 

Entry point 

HEMLDLIB 

HEMLLIBR 

Diagnostic dictionary 
processing 

HEWBUFFR 

Buffer allocation 
routine 

HEMLDIOC 

HEMLIOCA 

Buffer and DECB 
allocation routine 

HEHERROR 

Entry Point 

HEMLDLIB 

HEMLLIBR 

Error log routine 

HEWLCNVT 

Entry Point 

HEMLDREL 

HENLRELO 

Binary-Hex conversion 
routine 

HEWLCTRL 

Entry Point and 
CSECT 

HENLDCTR 

HENLCTRL 

Loader control module 

HEWLDCOM 

DSECT 

HEMLDIOC 

HEMLDLIB 

HEMLDREL 

HEMLIOCA 

HEMLLIBR 

HEHLRELO 

Communication area 

HENLDDEF 

CSECT 

HENLDDEF 

HENLDDEF 

SYSGEN option defaults 

HEHLEND 

Entry Point 

HEMLDREL 

HENLRELO 

End processing 

HEWLERTN 

Entry Point 

HEMLDREL 

HEHLRELO 

RLD relocation routine 

HEHLESD 

Entry Point 

HEMLDREL 

HENLRELO 

ESD record processing 
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Name 

Description 

Object Module 

CSECT 

Synopsis 

HEMLIDEN 

Entry Point 

HEMLDIDY 

HEMLIDEN 

Builds extent list for 
IDENTIFY and issues 
IDENTIFY 

HEMLIDEN 

Entry Point and 
CSECT 

HEMLDIDY 

HEMLIDEN 

Identification routine 

HEMLIOCA 

Entry Point and 
CSECT 

HEMLDIOC 

HEMLIOCA 

Initialization, I/O, 
control, and 
allocation processing 

HEMLLIBR 

CSECT 

HEMLDLIB 

HEMLLIBR 

Automatic library call 
and load module 
processing 

HEWLMAP 

Entry Point 

HEMLDREL 

HEMLRELO 

Creates map printout 

HEMLMOD 

Entry Point 

HEMLDREL 

HEMLRELO 

MOD record processing 

HEMLOAD 

Entry Point 

HEMLDIOC 

HEMLIOCA 

Entry point for 
loading with 
identification 

HEMLODE 

Entry Point 

HEMLDLIB 

HEMLLIBR 

Load module processing 

HENLPRNT 

Entry Point 

HEMLDIOC 

HEMLIOCA 

Print routine 

HEMLREAD 

Entry Point 

HEMLDIOC 

HEMLIOCA 

Read routine 

HEMLRELO 

Entry Point 

HEMLDREL 

HEMLRELO 

Object module 
processor 

HEWLRELO 

CSECT 

HEMLDREL 

HEMLRELO 

Object module, ESD, 

RLD, and map 
processing 

HENLRLD 

Entry Point 

HEMLDREL 

HEMLRELO 

RLD record processing 

HEHLTXT 

Label 

HEMLDREL 

HEMLRELO 

Object module text 
processing 

HEMOPNLB 

Entry Point 

HEMLDIOC 

HEMLIOCA 

Opens SYSLIB data set 

HEHPRIME 

Entry Point 

HEMLDIOC 

HEMLIOCA 

Object module buffer 
prime routine 

HEMTERM 

Entry Point 

HEMLDIOC 

HEMLIOCA 

SYSTERM routine 

IDMINI 

Label 

HEMLDIDY 

HEMLIDEN 

Constructs MINI-CESD 
for test package if 

TSO is operating 

INITMAIN 

DSECT 

HEMLDIOC 

HEMLIOCA 

Initial work area 

LMTXT 

Label 

HEMLDLIB 

HEMLLIBR 

Load module text 
processing 

MODELDCB 

Label 

HEMLDIOC 

HEMLIOCA 

Model DCB for SYSLIN, 
SYSLIB 

OPENEXIT 

Entry Point 

HEMLDIOC 

HEMLIOCA 

DCB exit routine 

PSEUDOR 

Label 

HEMLDLIB 

HEMLLIBR 

Processes pseudo 
registers 

SYNAD 

Entry Point 

HEMLDIOC 

HEMLIOCA 

SYNAD routine 
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Name 

Description 

Object Module 

CSECT 

Synopsis 

TRANSID 

Entry Point 

HEMLDREL 

HEHLRELO 

Translates ESD ID to 
CESD address 
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DATA AREAS 


This section provides a detailed description of internal data 
areas used during loader processing. The data areas are 
described in alphabetic order. 

Also included in this section is a summary of data area use and 
construction (Figure 25). 


Data Area 

Built By 

Used and/or Modified By 

Address list 

HEWACALL 

1 

BLDL list 

HEWACALL 

1 

CESD control table 
(CMTYPCHN) 

HEWLESD 

HENACALL, HEWLESD 

CESD table 

HEWLESD 

HEWACALL, HEWLERTN, HEWLESD, 
HEWLRLD, HEWLTXT, LMTXT 

Condensed symbol table 

HEWLIDEN 

TSO test facilities 

Extent chain 

HEWLMOD 

HEWLIDEN 

IDENTIFY parameter list 

HEWLIDEN 

IDENTIFY macro instruction 

HEWLDCOM 

HEWLIOCA 

2 

INITMAIN 

HENLIOCA 

1 

RLD table 1 

HEWLRLD 

HEWACALL, HEWLERTN, HEWLRLD 

Translation table 

HEWLESD 

HEWACALL, HEWLESD, HEWLRLD, 
HEWLTXT, LMTXT, TRANSID 


Figure 25. Data Area Construction and Usage 


Notes to Figure 25: 

1 Built and processed entirely within one routine. 

2 Major communication area throughout loader processing. 
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Address List 

Built by the Secondary Input Processor 


A] 

a 2 

-1- 

A 3 

■ 


An 


CESD entry address (4 bytes each entry) 

The entries in this list are in one-to-one 
correspondence with the BLDL list entries. 
The Loader stores the address from the BLDL 
entry in the address list before issuing the 
BLDL macro instruction 


Figure 26. Address List 


Built by Secondary Input Processor 


lo. 

2-3 

| 4-11 

12-15 

16-19 






(entry FFJ 


M - each entry -► 

16 bytes 

Not used by the Loader 


1- CESD cddress/TTR 

Originally contains the CESD address 
of an ER. (4 bytes) If the name was 
found in the SYSLIB directory, BLDL 
replaces the CESD address with TTR. 

- Name field (8 bytes) (bytes 12-14) 

TT - relative track number 
R - block number on the track 

Length (2 bytes) 

LL - length of each entry in the BLDL 
list (16 bytes in the Loader) 

- Number (2 bytes) 

FF - total number of entries in the BLDL list 

Figure 27. BLDL List 
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Note : The CESD control table is defined in the communications 
area (HEWLDCOM). 

Figure 28. CESD Control Table (CMTYPCHN) 
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CESD Table Ent 


Built by the ESD processor 


- Use depends on entry type 

Type LD - ESD ID for SD; preliminary use only (bytes 18-19) 

Type PR - boundary alignment (byte 16) and length (bytes 18-19) 
Alignments 

7 - doubleword 
3 - full word 
1 - halfword 
0 - byte 

Types SD, PC, LR, CM - relative relocation constant 
Type ER - 0; if ER was created from an LR - input address 
Type CM - address of extended portion of entry 


Address/displocement field (3 bytes) 

Types SD, PC, LR, CM - Loader-assigned address 

Types CM, PR, ER - address of RLD entry chain (0, if no RLDs) 

Type PR - displacement within DSECT 

Type LD - input address (preliminary use only) 


. Flags/type field (1 byte) FFFFF TTT; F^s are flogs, T|_ 3 indicate type 


Section definition (SD) - X0X00 000 

Label definition (LD) - 0X000 001 

External reference (ER) - XXXXX 010 


Label reference (LR) 
Private code (PC) 
Common (CM) 
Pseudo register (PR) 


- XOOOO 
-00000 
-00000 
-00000 


Ncmefiejd (8 bytes) 

8 character symbolic name or blanks for blank common 
and private code (unused for extended portion of CM entry) 


’ Chain address (4 bytes) 

Pointer to next entry on CESD type chain; if end of chain, 0. 
(unused for extended portion of CM entry) 


F|-“delete", Fg^'no length" 

F 2 “"LD processed" 

Fi-" delete," F 2 “"weck call," F 3 -*'BLDL tried," 
F 4 -"TTR found," F 5 - M never call" 

F]-"delete" 


Figure 29. CESD Entry 
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Condensed Symbol Table Entry 


Built by the Identification Processor 


0-7 


8 


9-11 


- Address - Assigned address of this 

symbol (3 bytes). 

Type - (1 byte) 

Section definition (SD) xxxxx 000 
Common (CM) xxxxx 101 


- Symbol - The 8-character external name (8 bytes). 


Figure 30. Condensed Symbol Table Entry 
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| Added by the 
-H Loader 


12-15 


16-19 


20-23 


DECDECPT (4 bytes) 
address of next DECB (4 bytes) 


DECIOBPT (4 bytes) 
address of the I/O block 


DECAREA (4 bytes) 
address of the read/write 
area for the data 


" IBAD (4 bytes) 

ss of the DCB for the read/write data set 


> read/write 


m and options 


_:b> 


LY26-3922-1 


© Copyright IBM Corp. 


1972, 1985 

















Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


Extent Chain Entry 


Built by the MOD Processor 


0-3 4-7 


8-11 


*-Length - Length of the extent (4 bytes). 

- Address - Address of the extent derived from 

the MOD record (4 bytes). 

Chain Address - Address of the next entry on the extent 
chain; if end of chain, zero (4 bytes). 


Figure 32 • Extent Chain Entry 
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*A hex '80* in the high-order byte signifies the lost length. 

Figure 33. IDENTIFY Parameter List 
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Offset 


Decimal 

Hex 

Length 

Symbol 

Description 

0 

0 

8 

CMXDBLMD 

Temporary doubleword 




(CMADC0N) 

Relocation alignment area 

8 

8 

4 

CMFSTSAV 

Pointer to first save area 

12 

C 

4 

CMBEGADR 

Default entry point to module 

16 

10 

4 

CMRDCBPT 

Input DCB pointer 

20 

14 

4 

CMWDCBPT 

Output DCB pointer 

24 

18 

4 

CMTDCBPT 

System DCB pointer 

28 

1C 

4 

CMRDECPT 

Input DECB pointer 

32 

20 

4 

CMWDECPT 

Output DECB pointer 

36 

24 

4 

CMGETREC 

Input logical record pointer 

40 

28 

4 

CMPUTREC 

Output logical record pointer 

44 

2C 

4 

CMTRMREC 

System buffer pointer 

48 

30 

4 

CMNXTTXT 

Next address to be assigned to a CSECT 

52 

34 

4 

CMLSTTXT 

Highest text address assigned to current CSECT 

56 

38 

4 

CMLOMTBL 

Lowest address assigned for loader tables 

60 

3C 

4 

CMHITBL 

Highest storage address available to loader 

64 

40 

4 

CMIOLST1 

Open list, DCB pointer tl 

68 

44 

4 

CMI0LST2 

Open list, DCB pointer #2 

72 

48 

4 

CMI0LST3 

Open list, DCB pointer #3 

76 

4C 

4 

CMC0RE1 

Corresponds to CMNXTTXT for pre-loaded text 

80 

50 

4 

CMC0RE2 

Corresponds to CMLSTTXT for pre-loaded text 

84 

54 

4 

CMTOPCOD 

Highest text address before common allocated 

88 

58 

4 

CMLIBEOD 

EODAD error routine pointer for passed SYSLIB 

92 

5C 

4 

CMLIBSYN 

SYNAD error routine pointer for passed SYSLIB 

96 

60 

4 

CMLIBEXL 

Exit list pointer for passed SYSLIB 

100 

64 

2 

CMBLKSIZ 

Block size of current input object module 

102 

66 

2 

CMMAXLNE 

Maximum line count CSYSPRINT) 

104 

68 

2 

CMMAPLIN 

Length of map line 

106 

6A 

2 

CMWLRECL 

SYSPRINT record size 

108 

6C 

2 

CMMAXLST 

Maximum length of invalid options list 

112 

70 

4 

CMMAINPT 

Variable conditional 6ETMAIN address 

116 

74 

4 

CMMAINSZ 

Variable conditional 6ETMAIN size 

120 

78 

8 

CMPRNTDD 

Print ddname 

128 

80 

8 

CMLINDD 

Primary input ddname 

136 

88 

8 

CMLIBDD 

Library ddname 

144 

90 

8 

CMTERMDD 

SYSTERM ddname 

152 

98 

8 

CMEPNAME 

Entry point name 

160 

A0 

8 

CMPGMNM 

Program name 

168 

A8 

4 

CMLINDCB 

Passed SYSLIN control block pointer 

172 

AC 

4 

CMLIBDCB 

Passed SYSLIB DCB pointer 

176 

B0 

1 

CMPRMFLG 

Parameter flags* 




CQRES 

X^l* RES/N0RES 




CQMAP 

X^ 1 MAP/NOMAP 




CQPRINT 

X^' PRINT/NOPRINT 




CQLET 

X , 08» LET/NOLET 




CQCALL 

X f 10 f CALL/NOCALL 




CQEPNAME 

X*20 v Entry point name defined 




CQEPADDR 

X^O* Entry point address defined 




CQTERM 

X^O* TERM/NOTERM 

177 

B1 

1 

CMIOFLGS 

I/O flags: 




CQEOCB 

X'Ol* End of concatenation 




CQEOFB 

X'QZ' End of file 




CQEOFSE 

X , 04 l End of file significance 




CQRECFM 

X*08* Input record format (0 is Fixed) 




(CQUNDEF) 

Separate name in allocation for undefined 




CQFIXED 

X f 10 f Fixed record format 




CQIGNCR 

X f 20 f Ignore control record on load module 




CQIOERR 

X'40 1 An I/O error has occurred 

178 

B2 

1 

CMFLAG3 

Assorted flags: 




CQTS 

X , 02 l Time-sharing environment 




CQPGMNM 

X'04 1 Program name passed 




CQPASLIN 

X v 08< SYSLIN DCB passed 


Figure 34 (Part 1 of 3). HEWLDCOM DSECT - Communication Area 
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Offset 

Decimal Hex Length Symbol 


Description 


179 


180 

184 

224 

228 

232 

236 

240 

244 

248 

376 

380 

384 

388 

392 

396 

400 

404 

408 

412 

416 

420 

424 

428 

432 

436 

440 

444 

448 

450 

452 

454 

456 

459 


459 


460 


B3 1 


B4 4 
B8 36 
E0 4 
E4 4 
E8 4 
EC 4 
F0 4 
F4 4 
F8 128 
178 4 

17C 4 

180 4 

184 4 

188 4 

18C 4 

190 4 

194 4 

198 4 

19C 4 

1A0 4 

1A4 4 

1A8 4 

1AC 4 
1B0 4 

1B4 4 

1B8 4 

1BC 4 
ICO 2 
1C2 2 

1C4 2 

1C6 2 

1C8 2 

1CA 1 


1CB 1 


ICC 1 


CQPASLIB 

CQINCORE 

CQIDEN 

CMFLAG4 

CQESDS 

CQMOD 

CQNOEX 

CQMINI 

COMVT 

CQCOMMON 

CQTRMOPN 

CQIDONE 

CMSYSTYP 

CMRSAVE 

CMXLCHN 

CMBITMAP 

CMERLIST 

CMRLDCHN 

CMESDCHN 

CMEPADDR 

CMTRCTRL 

CMBLDLPT 

CMCXDPT 

CMFRECOR 

CMMODLNG 

CMOBJST 

CMTEMPCH 

CMEPCESD 

CMPREVPT 

CMLOADCH 

CMESDSAV 

CMSDCHN 

(CMTYPCHN) 

CMLDCHN 

CMERCHN 

CMLRCHN 

CMPCCHN 

CMCMCHN 

CMPRCHN 

CMNULCHN 

CMCURRID 

CMLNECNT 

CMBLDLNO 

CMMTBFCT 

CMNUMXS 

CMLIBFLG 

CQKEEPS 

CQDELETE 

CQAUTOC 

CQCESDR 

CQNOTXT 

CQLPASRH 

CQFIRST 

CMRELFLG 

CQESD 

CQNOLNG 

CQDELINK 

CQLIB 

CQNOEND 

CQINPUT 

CQENTRY 

CQNOLNTX 

CMSTATUS 

CQPRTOPN 


X*10' SYSLIB DCB passed 
X'20* Processing incore SYSLIN 

X'40' Entered at IEHLOAD. Identification wanted 
Assorted flags: 

X'01' ESDs have been encountered 
X'02' MOD card has been encountered 
X'04' Execution not scheduled 
X*08' Mini-CESD built 
X'10* MVS operating 
X'20* Common received 
X*40' SYSTERM open 
X'80* Identification accomplished 
System type saved by HEWLDLIB 
Register save area used by HEHLDLIB 
Pointer to chain of extents 
Error bit map 

Pointer to errors encountered during open 
Free RLD entry chain (8 bytes/entry) 

Free CESD entry chain (22 bytes/entry) 

Entry point address to loaded program 
Translate control table 
BLDL pointer 

Pointer to CXD addresses 
Free storage chain 

Length of module currently being processed 

Starting point for object module 

Pointer to load chain entry to be freed 

CESD line address of the entry point name 

Previous element in a chain for insert-delete 

Temporary chain for ESDs in a load module 

CESD register save area for HEHLDREL 

Type 0 - Section definition - chain pointer 

Index point for the vector table 

Type 1 - Label definition - chain pointer 

Type 2 - External reference - chain pointer 

Type 3 - Label reference - chain pointer 

Type 4 - Private code - chain pointer 

Type 5 - Common - chain pointer 

Type 6 - Pseudo register - chain pointer 

Type 7 - Null entry - chain pointer 

ESDID counter 

Current line count for SYSPRINT 
Number of BLDL entries 
Horizontal byte count in print record 
Number of extents 

Autocall and load module processor flags: 

X'01* Keep some text from this record 

X'02' Delete some text from this record 

X'04' Autocall is in process 

X* 08' CESD has been received for load module 

X'10* Text has been received 

X'20' LPA resolution possible 

X'40' First record from load module was CESD 

Relocation and object module processor flags: 

X'01* ESD routine is caller to ID translate rtn 

X'02' Length not yet received from current 

CSECT 

X'04' Delinking if required for common 
X'08' Resolution from SYSLIB in process 
X'10* End card has been received 
X'20' Input has been received 
X'40' RLD is for entry point 
X*80' Text received for no-length CSECT 
Loader status flag: 

X'01' Print DCB allocated for 


Figure 34 (Part 2 of 3) 


HEWLDCOM DSECT - Communication Area 
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Offset 

Decimal Hex Length Symbol Description 


CQLIBOPN X'02* 

CQABORT X*04* 

CQREJOPT X*08' 

CQOPNERR X'10* 

CQRETURN X'20' 

CQMSGSAV X'40• 

CQPRTDCB X'80» 

461 1CD 1 CMPRTCTL Index 

462 ICE 1 CMOPTECT Count 


Library DCB open 
Abort loading 

Invalid options are to be printed 
Errors were encountered during open 
Caller to error rtn must regain control 
Request open exit to save error messages 
Print DCB is open 
for printer carriage control 
of invalid options to be printed 


Figure 34 (Part 3 of 3). HEHLDCOM DSECT - Communication Area 


Notes to Figure 34: 

1. Symbols in parentheses are equated to preceding symbol. 

2. Locations CMMAINPT through CMFLAG4 are initialized from 
locations INITMADR through INFLAG4 in INITMAIN (Figure 36 on 
page 85) by HENLDIOC. 

3. Locations CMBITMAP through CMOPTECT are initialized to zero 
by HEWLDIOC. 


HEWLDDEF 


HEHLDDEF is a static CSECT that defines default options and 
ddnames to be used by the loader. 

During loader execution, the default values are moved to dynamic 
storage (INITMAIN), where they are modified by the parameter 
list values passed internally. The HEHLDDEF CSECT is described 
in Figure 35 on page 84. 
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Dec Hex 
0 0 


8 8 


16 10 


24 18 


28 1C 


32 20 

"Correspond to CMPRMFLG flags. See Figure 34 
Figure 35. HEWLDDEF CSECT 
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Offset 




Decimal 

Hex 

Length 

Symbol 

Description 

0 

0 

72 

INITSAVE 

Initial save area 

72 

48 

4 

INITMADR 

Variable conditional GETMAIN storage address 

76 

4C 

4 

INITMSIZ 

Variable conditional GETMAIN storage size 

80 

50 

8 

INITPRNT 

ddname for diagnostic message data set 

88 

58 

8 

INITLIN 

ddname for primary input data set 

96 

60 

8 

INITLIB 

ddname for autocall library data set 

104 

68 

8 

INITTERM 

ddname for SYSTERM data set 

112 

70 

8 

INITNAME 

Parameter list entry point name 

120 

78 

8 

INITPGMN 

Program name 

128 

80 

4 

INLINDCB 

Address of passed SYSLIN DCB 

132 

84 

4 

INLIBDCB 

Address of passed SYSLIB DCB 

136 

88 

2 

INITPARM 

Parameter flags and error flags 

138 

8A 

1 

INFLAG3 

Assorted flags 

139 

8B 

1 

INFLAG4 

Assorted flags 

140 

8C 

4 

INITSPIE 

Pointer to previous SPIE for 'SIZE* 1 SCAN 

144 

90 

4 

INITSCAN 

Scan pointer save area for , SIZE= f SPIE 

148 

94 

4 

INITDUM 

Save word for register during size processing 

152 

98 

4 

INITREJL 

End of rejected options list 

156 

9C 

4 

INITRMIN 

Minimum size request for variable conditional 
GETMAIN 

160 

A0 

4 

INITRMAX 

Maximum size request for variable conditional 
GETMAIN 

164 

A4 

12 

INITGTML 

Parameter list area for variable conditional 
GETMAIN 

176 

B0 

12 

INITEXTR 

Parameter list area for Extract 

188 

BC 

4 

INITEXAD 

Address of TCB TSO field from Extract 

192 

CO 

8 

INITDBLW 

Doubleword for parm ■SIZE 1 conversion 

200 

C8 

256 

INITRTAB 

Translate and test table for option scan 

456 

1C8 

VL 

INITREJP 

Rejected options buffer 


Figure 36. INITMAIN DSECT Definition 


Note to Figure 36: 

Locations CMMAINPT through CMFLAG4 in HEHLDCOM (the 
communication area Figure 34 on page 81) are initialized from 
locations 1NITMADR through INFLAG4 in INITMAIN. 
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RLD Table Entry 


0-3 


4 


5-7 


Loader - assigned address of address constant in text (3 bytes) ■ 


Flagfield - FXXXLLST (1 byte) 

FXXX - type of adcon 

xOOO - A-type adcon 

xOOl - V-type adcon 

0010 - displacement pseudo register 

0011 - accumulative pseudo register 

Note: F=1 - use absolute relocation constant for relocation 
LL - length of adcon 

01 - two bytes 

10 - three bytes 

11 - four bytes 

S - direction of relocation 

0 - add the relocation constant 

1 - subtract the relocation constant 

T - not used by the Loader; input value is retained 


*- Address of next entry on this RLD chain. 

0 if end of chain. (4 bytes) 

Figure 37. RLD Table Entry 


Translation Control Table 



4-7 


Uf 


123-127 

1 

-Address of extent allocated for the translation 


table. Each entry is initialized to zero (4 bytes) 


Note: This table is defined in the communications area (HEWLDCOM) 
at location CMTRCTRL. 

Figure 38. Translation Control Table 
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Translation Table E ntry 
Built by the ESD Processor 



0 = normal (relative) relocation required 
1 = special (absolute) relocation required 

Note: A translation table extent contains 

32 of these entries. The Loader can allocate 
a maximum of 32 extents. When allocated, 
an extent is initialized to zero. 

Figure 39* Translation Table 
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ms m sn&Aiaa 


This section contains information that is useful in diagnosing 
difficulties with the loader program. Included ares register 
contents at entry to routines (Figure 40), error code 
definitions (Figure 41 on page 90), an example of a module map 
(Figure 42 on page 91), and a list of serviceability aids 
available with the loader. To use this section, refer to 
Figure 20 on page 61 through Figure 24 on page 67 which show the 
logic flow, and Figure 25 on page 73 which shows data area 
usage. 


Note: At the entry point to each module, register 13 contains the save area address 
and register 14 contains the return address. 


Module 


Entry Point Register Contents 


HEMLCTRL 

HEHRELO HEWLRELO 

HEWLESD 

HEWLTXT 


HEWLMOD 

HEMLRLD 

HEWLEND 

TRANSID 

HEWLERTN 

HEWLMAP 

HEWLCNVT 


I - address of parameter list 

II - address of communication area 

5 - ID of first ESD item other than LD 

7 - length of ESD information 

S - address of ESD information 
11 - address of communication area 

5 - Text ID 

6 - displacement address of text 

7 - length of text 

8 - address of text in object module buffer 
11 - address of communication area 

7 - length of MOD information 

8 - address of MOD information 

11 - address of communication area 

7 - length of RLD information 

8 - address of RLD information 

11 - address of communication area 

5 - ID of entry point (if present) 

6 - address of entry point (if present) 

8 - address of symbolic entry point name (if 

present) 

11 - address of communication area 

5 - ESD ID to be translated 

11 - address of communication area 

I - starting address of RLD chain 

9 - CESD entry address to be used for relocation 

II - address of communication area 

9 - address of CESD entry to be mapped 

11 - address of communication area 

I - binary quantity to be converted 

II - address of communication area 


Figure 40 (Part 1 of 2). Register Contents at Entry to Routines 
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Module 

HENLLIBR 


HEHLIOCA 


HEHLIDEN 

Figure 40 


Entry Point 
HEHLODE 

HEHERROR 

HEHACALL 

HEWBTMAP 

HEHLIOCA 

HEHLOAD 

OPENEXIT 

HEWBUFFR 

HEHLREAD 


HEHOPNLB 

HEHLPRNT 

HEHTERM 

HEHPRIME 

HEHLIDEN 

IDMINI 


Register Contents 

11 - address of communication area 
15 - entry point address 

0 - error message code 

I - pointer to qualifying information (if it 

exists) 

II - address of communication area 
15 - entry point address 

11 - address of communication area 
15 - entry point address 

11 - address of communication area 
15 - entry point address 

1 - address of parameter list 

15 - entry point address 

1 - address of parameter list 

15 - entry point address 

I - address of DCB 

II - address of communication area 

12 - base address of HEHLIOCA 

10 - address of DCB 

11 - address of communication area 

15 - entry point address 

For Object and Load Modules 

11 - address of communication area 
15 - entry point address 

For Load Modules 

a. read control/RLD record 
0 - zero 

b. read text records 

0 - length of text record 
1 - address of text 

c. read text and control/RLD 

0 - complement of length of text 
1 - address of text 

11 - address of communication area 
15 - entry point address 

11 - address of communication area 
15 - entry point address 

11 - address of communication area 
15 - entry point address 

11 - address of communication area 
15 - entry point address 

11 - address of communication area 

5 - starting address for mini-CESD 

10 - upper limit of storage available 


(Part 2 of 2). Register Contents at Entry to Routines 
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ERROR COPE DEFINITIONS 

Figure 41 contains the loader error codes listed in the order of 
their bit positions in the error-bit map. (The codes are also 
listed in DSECT ERCODES in CSECTs HEWLIOCA, HEMLRELO, HEMLLIBR, 
and HEHLIDEN.) 


Error 

Code Definition Sev Message 


ERREL01 Unresolved external reference (NOCALL specified) 1 


ERENTR1 No entry point received 1 
ER1NPT8 Card received not an object record 1 
ER1NPT10 No END card received 2 
ERINPT2 Invalid length specified 2 
ERREL02 Unresolved external reference 2 
ERINPT4 Doubly defined ESD 2 
ERINPT5 Invalid 2-byte adcon 2 
ERINPT7 Invalid ID received 2 
ERINPT9 Invalid record from object module 2 
ERINPT1 Block size is invalid 2 
ERINPT11 Common exceeds size of CSECT with same name 2 
ERINPT12 Invalid 3-byte adcon 2 
ERINPT3 No text received 3 
ERENTR2 Entry point received but not matched 3 
ERI0UT4 I/O error while searching library directory 3 
ERINPT6 Invalid record from load module 3 
ERI0UT3 Unacceptable record format (variable on input) 4 
ERI0UT1 ddname cannot be opened 4 
ERI0UT2 ddname had synchronous error 4 
ERSIZE2 Available storage exceeded 4 
ERSIZE3 Too many external names in input module 4 
ERIDEN1 Identification failed; duplicate program name 4 
ERIDEN2 Identification failed 4 


IEW1001 
IEMI161 
IEMI141 
IEN1182 
IEMI082 
IEM1012 
IEMI102 
IEN1112 
IENU32 
IEMI152 
IEM1072 
IEN1232 
IEM1262 
IEM1093 
IEN1173 
IEMI053 
IEM1123 
IEMI044 
IEMI024 
IEMI034 
IEH1194 
IEM1204 
IEMI214 
IEM1224 


Figure 41. Internal Error Code Definitions 
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Module Map Format 


Map heading 

Name Type 

Addr 

Name 

Type 

Addr 

Name 

Type 

Addr Name Type 

Addr 

CSECTs, entry points 

Main SO 

9000 

ENTRY 

LR 

9050 

ENTRY2 

LR 

9100 SUB1* SD 

A000 


SU82* SO 

A100 








Common entry 

$ BLANKCOM 

CM 

A200 







Pseudo Register 

IHEQINV PR 

00 

IHEQERR 

PR 

04 

IHEQTIC 

PR 

08 IHEQLWF PR 0C 

IHEQLWO PR 10 

information 

IHEQSLA PR 

14 








Length of loaded 
program 

TOTAL LENGTH 

2000 








Entry of loaded 

ENTRY ADDRESS 9050 








program 











Notes: 

• Name * denotes a module included from the SYSUB data set. 

• Nome ** denotes a module included from the link pock area. 

• Name *** denotes a module pointed to by a MOD record. 

• The map entries are mode as addresses are assigned, so the 
map reflects the order of ESD entries in the CESD. 

Figure 42. Module Map Format Example 


SERVICEABILITY AIDS 


Following are serviceability aids provided in the loaders 

• The control section, HENLDDEF, contains the loader option 
default values. It is resident in load module HEHLOADR. 

• A storage dump will typically produce information on the 
nature of the error. Register 11 will contain a pointer to 
HEWLDCOM, and register 12 will contain the base register 
associated with the CSECT in control. 

• All nine save areas are forward and backward chained. 

Lower—level save areas will be printed. A hexadecimal "FF" 
in word 4 of the save area indicates that the routine 
represented by the save area has returned control. 

• Input/output control information is contained in the loader 
communication area. This information consists of the DECB 
address, the buffer locations, the block size, the logical 
record length, the blocking factor, the number of records 
left in the buffer, the address of the current record, and 
the associated switches. See Figure 37 on page 86 for the 
layout of HEWLDCOM. 

• Appropriate diagnostic messages are produced when an error 
has been detected. The message has a specific number and, 
where appropriate, lists the data in error. The message 
number and text are listed by HEWLLIBR at the end of 
loading. (Figure 47 on page 97 is a list of these 
messages.) 

• A module map (MAP) is provided to furnish information 
concerning the structure and contents of the program. 

Figure 46 on page 96 is an example of a map listing. 

• The loader uses the SYNADAF to obtain information regarding 
permanent I/O errors, and lists the information on the 
SYSLOUT data set. 
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APPENDIX. ERROR MESSAGES* ETC. 


This appendix contains a list of error messages and the routines 
and CSECTs in which they originate# a list of loader input 
conventions and restrictions# and detailed descriptions of input 
record formats. (The input record formats are the same as for 
the Linkage Editor Programs.) In addition# the compiler/loader 
interface is described for the processing of the data sets 
passed to the loader. 

Figure 43 lists the loader diagnostic messages. Each message 
contains a severity code in the final position of the message 
number. These severity codes are defined as followsi 

0 indicates a condition that will not cause an error during 
execution of the loaded program. 

1 indicates a condition that may cause an error during 
execution of the loaded program. 

2 indicates an error that can make execution of the loaded 
program impossible. 

3 indicates an error that will make execution of the loaded 
program impossible. 

4 indicates an unrecoverable error. Such an error causes 
termination of loading. 


Message 

Number 

Message 

Text 

Issuer 

Routine 

Issuer CSECT 

IEH1001 

Naming - Unresolved external reference 
(N0CALL specified) 

HEHACALL 

HEMLLIBR 

IEW1012 

Error - Unresolved external reference 

HENACALL 

HEHLLIBR 

IEMI 024 

Error - Ddname cannot be opened 

HEMLIOCA 

HEMLIOCA 

IEMI034 

Error - Ddname had synchronous error 

SYNAD 

HEMLIOCA 

IEMI044 

Error - Unacceptable record format 
(variable on input) 

0PENEXIT 

HEMLIOCA 

IEH1053 

Error - 1/0 error while searching 
library directory 

HEMACALL 

HEHLLIBR 

IEMI072 

Error - BLKSIZE is invalid 

OPENEXIT 

HEMLIOCA 

IEN1082 

Error - Invalid length specified 

HEHLEND 

HEHLRELO 

IEMI093 

Error - No text received 

HENACALL 

HEHLLIBR 

IEMI102 

Error - Doubly defined ESD 

HENLESD 

HEHLRELO 

IEN1112 

Error - Invalid 2-byte adcon 

HEMLRLD 

HEHLRELO 

IEMI123 

Error - Invalid record from load module 

HEML0DE 

HEHLLIBR 

IEN1132 

Error - Invalid ID received 

HEMLRLD 

HEMLTXT 

HEMLEND 

TRANSID 

HEHLRELO 

HEHLRELO 

HEHLRELO 

HEHLRELO 


Figure 43 (Part 1 of 2). Error Message/Issuer Cross-Reference Table 
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Message 

Number 

Message 

Text 

Issuer 

Routine 

Issuer CSECT 

IEH1141 

Warning - Card received not an object 
record 

HEHLRELO 

HEHLRELO 

IEW1152 

Error - Invalid record from object 
module 

HEHLRELO 

HEHLRELO 

IEMI161 

Warning - No entry point received 

HEHACALL 

HEHLLIBR 

1EMI173 

Error - Entry point received but not 
matched 

HEHACALL 

HEHLLIBR 

IEMI182 

Error - No END card received 

HEHLRELO 

HEHLRELO 

IEH1194 

Error - Available storage exceeded 

HEMBUFFR 

HEMLESD 

HEMLEND 

HEMLTXT 

HEHACALL 

HEMLODE 

HEHLIDEN 

HEHLIOCA 

HEHLRELO 

HEHLRELO 

HEHLRELO 

HEHLLIBR 

HEHLLIBR 

HEHLIDEN 

IEM1204 

Error - Too many external names in input 
module 

TRANSID 

HEHLRELO 

IEM1214 

Error - Identification failed - 
duplicate program name found 

HEHLIDEN 

HEHLIDEN 

IEM1224 

Error - Identification failed 

HEHLIDEN 

HEHLIDEN 

IEMI232 

Error - Common exceeds size of CSECT 
with same name 

MATCHCM 

HEHLRELO ' 

IEMI262 

Error - Invalid 3-byte adcon 

KEHLERTN 

HEHLRELO 

1EM1991 

Error - User program has abnormally 
terminated 

HEHLCTRL 

HEHLCTRL 


Figure 43 (Part 2 of 2). Error Message/Issuer Cross-Reference Table 


INPUT CONVENTIONS 


Input modules (object or load) to be processed by the loader 

must conform with a number of input conventionss 

• All text records of a control section must follow the ESD 
record containing the SD or PC entry that describes the 
control section. 

• The end of every input module must be marked by an end 
indication (END record in an object module# EOM flag in a 
load module.) 

• Any RLD item must be read after the ESD items to which it 
refers and after the TXT item in which it is positioned. 

• (Applicable only to FORTRAN IV language processing.) Once a 
BLOCK DATA subprogram has been received, any following named 
common referencing it must not specify a longer length. 

• Because each control section is assigned an address as it is 
encountered in the input stream, any control section 
appearing between the ESD for a •no-length* CSECT and the 
END card for that •no-length* CSECT will have an erroneous 
address assigned. (A •no-length* CSECT is a control section 
whose length is defined on the END card.) 
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• Each record of text and each LD or LR type ESD record must 
refer to an 5D or PC entry in the ESD, 

• The position pointers of every RLD record must point to an 
SD or PC entry in the ESD. 

• No LD or LR may have the same name as an SD or CM. 

• The loader accepts TXT records that are out of order Mi thin 
a control section. TXT records are accepted even though 
they may overwrite previous text in the same control 
section. The loader does not eliminate any RLD records that 
correspond to overwritten text. 

• During a single execution of the loader* if two or more 
control sections having the same name are read in* the first 
control section is accepted; the subsequent control sections 
are deleted. 

• The loader interprets common (CM) ESD items (blank or with 
the same name) as references to a single control section 
whose length is the maximum length specified in the CM items 
of that name (or blank). No text may be contained in a 
common control section. 

• (Applicable only .to Assembler language programming.) When 
control sections that were or are part of a separately 
assembled module are to be replaced* A-type address 
constants that refer to a deleted symbol will be incorrectly 
resolved unless the entry name is in the same position 
relative to the origin of the replaced control section. If 
all control sections of a separately assembled module are 
replaced* no restrictions apply. 

• The MOD record must physically precede all ESD records for 
an internal object module and logically replace all text 
records. If a MOD record appears as the first record of an 
internal object module* all succeeding text records are 
ignored until an END statement has been processed. A MOD 
record is ignored if it appears outside an internal object 
module* if it appears after other records have been 
encountered for a module* or if its byte count is zero. 


INPUT RECORD FORMATS 


Figure 44 through Figure 56 on page 105 show input record 
formats. 


SYM Input Record (Cord Image) - Ignored by the loader 


in 

D 

5-10 

11,12 

13-72 

73-80 

i . 


Not used 


1 - TESTRAN doto 

Number of bytes of TESTRAN data 


Blank 


I- SYM 

- 12 - 9 - 2(0000 0010 ) 

Figure 44. SYM Input Record (Card Image)—Ignored by the Loader 
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Figure 46. Text Input Record (Card Image) 
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RLP Data Item 


E 

3,4 

5 

6,7,8 


I I Assigned address of address constant 

I Flog field — (TTTTLLSTn) 

TTTT = type 
0000 = non-branch 
0001 = branch 

0010 = pseudo register displacement value 
0011 = pseudo register cumulative length 
LL = length of address constant 
01 = 2 bytes 
10 = 3 bytes 
11=4 bytes 

Position pointer (P) - HSDID of SD for control section 
—— Relocation pointer (R) - ESDID of CESD entry for the symbol being referred to. Zero (00) if type = PR cumulative length 

Figure 47. RID Input Record (Card Image) 


S = Direction of relocotion 
0 = positive (+) 

1 = negative (-) 

Tn = type of next RLP item 
0 = next RLD item has a different R or P 

pointer; they are present in the next item. 

1 = next RLD item has the same R and P pointers, 
hence they are omitted 

that contains the address constant 


LY26-3922-1 


© Copyright IBM Corp. 1972 


1935 


Appendix. Error Messages. 


Etc. 97 










Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


END Input Record - Type 1 (Card Image) 


9-14 15,16 


•- IDR data, ignored by the Loader 

Control section length for control section whose length 
was not specified In SD ESD item. Byte 29 is binary 
zero rather than a blank if length is present. 


ESDID of SD item for this control section that contains the entry point address specified in bytes 6-8. 


24-bit address of entry point (optional) 


12-9-2 (0000 0010) 


Figure 48. END Input Record—Type 1 (Card Image) 



END Input Record - Type 2 (Card Image) 


12-9-2(0000 0010) 


IDR data, ignored by the Loader 


Control section leng th for control section whose length 
was not specified in SD ESD item. Byte 29 is binary 
zero rather than a blank if length is present. 


Symbolic entry point name (optional) 


Figure 49. END Input Record—Type 2 (Card Image) 
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SYM Record* ( Load Module) 


Z 


2,2 


4-243 


E 


SYM data and ESP data (ESP type SD, CM and PC items) - (maximum of 240 bytes) 


*- Count - in bytes, of SYM and ESD data (2 bytes) 

Subtype - specifies information for TESTRAN - (1 byte) 

1000 0000 - this SYM record contains ESD items (SD, PC or CM) from 
a load module that was not “under test". The test 
option was not specified when it was link edited. 

0000 0000 - this SYM record is not the above type. 


*- Identification - specifies this is a SYM record -- 0100 0000 (1 byte) 


Figure 50. SYM Record (Load Module)—Ignored by the Loader 
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CESD Record - (toed Module) 



1 

D 

2.3 

4,5 

D 

8-247 

up to 240 bytes of ESD data 


ESP dato - for detailed information see below, 
■ Count - in bytes, of ESD data (2 bytes) 

■ — ESDID of first ESO item (2 bytes) 


Li Spare - 2 bytes of binary zeros 


1 -Flag (1 byte) 

OXXX XXXX - byte 12 of CESD data items contains 
segment numbers 

1XXX XXXX - byte 12 of CESD data items contains 
AMODE/RMODE data 


(dentificotlon — 0010 0000 - (1 byte) 


CESD Doto (load Module) 


1-8 

9 

10-12 

13 

14-16 | 


n 


ID/length ■ 


length (3 bytes), when type is: SD, PC, CM or PR 
ID (2 bytes), when type is LR 
Zero (3 bytes), when type is ER, WX, or Null 

Alignment factor (PR) | 07 - doubleword 
03 - fullword 
01 - halfword 
00 - byte 

Zero (ER, WX. Null) 

If flag byte (byte 1) indicates CESD data items contain 
segment numbers - segment number (SD, PC, CM, LR) 

If flag byte (byte 1) indicates CESD data items contain AMODE/RMODE data - 
XXXX.... not used 
. . . . R . . . RSECT information (ignored) 

.R . . RMODE data 

0 = 24 

I = ANY 

.A A AMODE data 

00,01 = 24 
10 = 31 

II = ANY 


(SD, PC) 

Address - linkage editor-assigned address of this symbol. Zero when type is ER, WX, or Null (3 bytes) . 


— Type - (1 byte) Section definition (SD) 

Label reference (LR) 

Private code (PC) 

Private code marked delete 
(ENTAB and SEGTAB control sections) 
Common (CM) 

Null 

External reference (ER) 

Weak external reference (WX) 

Pseudo register (PR) 

■ Symbol - The 8-character external name — Zero when type is Null. 

Blanks If blank common or PCs other than SEGTABs and ENTABs 


XXXXXOOO 
XXXXX011 
XXXXX100 

XXX1X100 

XXXXX101 

XXXXXUI 

XXXXX010 

XXXX1010 

xxxxxno 


X's may be 1 or 0 


Figure 51. CESD Record (Load Module) 
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Scatter - Translation Record 


0 1 2-3 


4-1023 


? 


Up to and including 1020 bytti 


L Data - may contain translation table, translation table and scatter table, or scatter table only 


Count - in bytes, of data field 


1 ■ ■ Zero - one byte of binary zeros 


Identification - identifies this as a scatter-translation record - bit configuration is: 0001 0000 


Translation Table 

' ri i rift 


I—— Podding (2 bytes) - if necessary, to force fullword boundary alignment of scatter table. 

* " Pointer (2 bytes) - to the scatter table entry that contains the address of the control section 

containing this CESD entry. 

Number of translation table entries = number of CESD entries +1. 

Pointer will be zero if its corresponding CESD entry is not SD, PC, CM, or LR. 


Zero - 2 bytes of binary zeros 


Scatter Table 


c 


n 


Assigned address (3 bytes) - of a control section (SD. PC or CM) 


* Flags (1 byte) 

X X X X 


■ Zero - 4 bytes of binary zeros 


not used 

RSECT information 
0 = not read-only 
1 = read-only 
RMODE data 
0 = 24 
1 = ANY 

Hierarchy (OS/MVT) 

0 = processor storage 
1 = 2361 storage 


Trcnslotion Table and Scatter Table 


E 

T- 

T 0 

n 

a 

ns 

T 

T 

P 

S 1 


S, 

S 

■11 





si 

2 

3 

■ 

■ 

*» 


n 



2 

3 


Wii 





llI 


Scatter data 


■ Podding (2 bytes) if necessary to align scatter table to a fullword boundary* 


Trcnslotion data 


Figure 52. Scatter/Translation Record—Ignored by the Loader 
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Control Record - (Load Module) 


fl 



4-5 

6-7 

8-15 

■ 

■ 

11 Record Length 20 to 256 bytes 


Length of text record and/or length of control section - specifies the length of 
the control section (in bytes) to which the text in the following 
record belongs, or the number of bytes of a control section contained 
in the following text record (2 bytes) 

CESD entry number - specifies the composite external symbol dictionary entry that 
contains the control section name of the control section of which this text is a 
part (2 bytes) 

Channel Command Word (CCW) - that could be used to read the text record that follows. The data address field 
contains the linkage editor assigned oddress of the first byte of text in the text record that follows. The 
count field contains the length of the succeeding text record. 

■— Count - contains 2 bytes of binary zeros. 

I— Count - in bytes, of the control information (CESD ID, length of control section) following the CCW field. 

— Count - (1 byte) of RLD and/or CTL/RLD records following next text record. 

- Spare — contains 2 bytes of binary zeros. 

- Identification - specifies that this is: 

• A control record - 0000 0001 

• The control record that precedes the last text record of this overlay segment - 0000 0101 (EOS) 

• The control record that precedes the last text record of the module - 0000 1101 (EOM) 

(I byte) 


Figure 53. Control Record (Load Module) 
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Relocation Dictionary Record - (Load Module) 


□ 

1-3 



8-15 

16-255 

Record length can be between 24 and 256 


■-RID data— see below 


- Spore - contains 8 bytes of binary zeros 


Count * in bytes of the relocation dictionary information following the spare 8 byte field (2 bytes) 


Count - contains two bytes of binary zeros 


-Jpore - contains three bytes of binary zeros 

Identification - specifies that this is: (1 byte) 

• A relocation dictionary record - 0000 0010 

• The last record of this segment - 0000 0110 

• The last record of the module - 0000 1110 


RID Data 




2 ! 


Address - linkage editor 

assigned address of 
the address constant 
(3 bytes) 


* - Flog " (1 byte) When byte format is xxxxLLST, 

specifies miscellaneous information as follows: 

xxxx specifies the type of this RLD item (address constant). 

0000 — non-branch type in assembler language, DC A (name) 

0001 — branch type in assembler language, DC V (name) 

0010 — pseudo register displacement value 

0011 — pseudo register cumulative displacement value 

1000 and 1001 — this address constant is not to be relocated because it refers to an unresolved symbol. 
LL specifies the length of the address constant. 

01 — two bytes 

10 — three bytes 

11 — four bytes 

S specifies the direction of relocation. 

0 — positive 
1 — negative 

T specifies the type of the next following RLD item. 

0 — the following RLD item has a different relocation and/or position pointer. 

1 — the following RLD item has the same relocation and position pointers as this and therefore contains 
only the flag and address fields. 


■■■■ Position pointer - contains the entry number of the CESD entry that indicates 
which control section holds the address constant (2 bytes). 


Relocation pointer - contains the entry number of the CESD entry that indicates which symbol value 
is to be used in the computation of the address constant's value (2 bytes). 

Oif PR cumulative length or if ENTABCSECT. 


Figure 54. Relocation Dictionary Record (Load Module) 


LY26-3922-1 


© Copyright IBM Corp. 


1972. 1985 


Appendix. Error Messages. Etc. 103 















contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 













Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


CSECT Identification Record - (toad Module) 



IDR data * (maximum of 253 bytes) 


Sub-Type Indicator - (1 byte) - specified type of 
IDR data contained on this record (bits 1-3 reserved) 


Data supplied by IMASPZAP 
Linkage Editor data 
Translator-supplied data 
User (System)-supplied data 
(from IDENTIFY function) 

Indicates the last IDR of this load module 


XXXX0001 

XXXX0010 

XXXX0100 

XXXX1000 

1XXXXXXX X's may be 1 or 0 


-► Count , in bytes, of IDR data in this record, including this field (value range 6 to 255)* 


Identification - indicates that this is a CSECT Identification record — 1000 0000. 


Figure 56. Record Format of IDRs (Load Module)—Ignored by the Loader 


COHPILER/LOAPER INTERFACE FOR PASSED DATA SETS 

If the loader is to process an internal SYSLIN data area (that 
is* a data area residing in virtual storage and consisting of 
contiguous object module records prepared by a compiler) and/or 
an open SYSLIB data set# the compiler/loader interface described 
here is used. The description includes the format of the DCB 
list# the control block or DCB parameters that must be specified 
for the data area or data set# the format of an internal data 
area consisting of either fixed- or variable-length records# and 
the format of the MOD record. 
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DCB List 


Pointed to by the fourth entry in the parameter I ist passed to the Loader 


0-1 

2-3 

4-7 

8-11 

12-15 

16-19 


L. SYSLIB DCB - may 
contain the address 
of an open SYSLIB DCB 
(4 bytes). 

Zero - 4 bytes of binary zeros. 

I— Zero - 4 bytes of binary zeros. 

•— SYSLIN control block - may contain the address of a 
SYSLIN control block which describes an internal 
data area prepared by a compiler (4 bytes). 

*— Zero - 2 bytes of binary zeros. 

Number of entries following (2 bytes). 

Figure 57. DCB List 


Internal SYSLIN control Block 


The SYSLIN control block 23 used to describe an internal input 
data area should have the following fields initialized* 

DCBDEVT = 0. to describe an internal data area and to indicate 

that an internal SYSLIN control block was passed. 

DCBRELAD = starting address of the internal object module 
records. 


DCBBLKSI = length of the entire internal data area. 

DCBRECFM = FB, if the internal object module records are in 
fixed-length format. 

VB, if the internal object module records are in 
variable-length format. 

DCBLRECL - length of a logical record if the data set records 
are .in fixed-length format. 


23 The control block has the format and content of a SYSLIN 
data control block, but is not to be considered a data 
control block because there is no data management activity 
in connection with this control block. 
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open SYSL1B DCB 


The open SYSLIB DCB passed to the loader should have the 
following DCB fields initialized* 


DCBDSORG = PO 
DCBMACRF = R 


DCBNCP = 
DCBRECFM 


DCBBUFNO 


2 

U* if the SYSLIB data set contains load modules. 

F or FB* if the SYSLIB data set contains object 
modules. (In this case* values for the fields 
DCBLRECL and DCBBLKSI should also be specified.) 

0 


Exit routine addresses may be specified. Before reading SYSLIB* 
the loader overlays these addresses with the addresses of its 
own routines. The loader also restores these addresses before 
returning to the caller. 

If an open SYSLIB DCB is passed to the loader* SYSLIB is not 
closed by the loader. 


(Logical record length = 72) 


1-72 

73-144 


n-n+71 


c 


I— Second record 
of data area 


Nth record 
of data area 


I-First record 

of data area 
(This record 
should begin 
on a ful Iword 
boundary. Its address 
should appear 
in the passed 
SYSLIN control block 
field DCBRELAD.) 

Figure 58. Internal Data Area in Fixed-Length Record Format 
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Slock 

Descriptor 

Word 


Descriptor 

Word 


Descriptor 

Word 


Descriptor 

Word 


2 

2 

LI 

2 

2 

L2 



Length (LI) of first 
reoord of data area 
plus descriptor 
word (This field 
must fall on a 
full word boundary.) 


Length (L2) of second 
record of data area 
plus descriptor 
word (This field 
must fall on the 
fullword boundary 
following the end 
of the previous 
reoord.) 


- nth reoord 
of data area 


1 -Binary zeros 

- Length (Ln) of nth reoord 
of data area plus 
descriptor word (This 
field must fall on the 
fullword boundary 
following the end of 
the previous record.) 


Figure 59. Internal Data Area in Variable-Length Record Format 



Not used. 

♦Number of bytes of text 
(optional) (4 bytes) • 


* Address of text extent (optional) 
(4 bytes). 

Address of byte following the estimated 
or actual end of text for the last 
control section in the module (4 bytes). 

Main storage address of the first byte of text 
for the first control section in the module. 

This address should be on a doubleword boundary. 

(The Loader assumes that each succeeding control 
section within the module begins on the next 
available doubleword boundary.) (4 bytes) 


1— Blank (4 bytes). 

L- Number of bytes of data to be processed in columns 17-32 
(number = 8 or 16) (2 bytes). 

I—Blank (6 bytes). 

•-MOD (3 bytes). 

-12-9-2 (0000 0010) (1 byte). 

♦Note: These two fields define storage that is to be identified as part of the loaded program. They 
are optional, but must occur on at least one of the MOD records in the internal data area if the 
Loader is invoked via the entry points LOADER, HEWLDRGO, or HEWLOAD. Each occurrence of 
these two fields defines a new extent of the program. The values must conform to the rules for 
FREEMAIN parameters, that is, the address must begin on a doubleword boundary and the length 
must be a multiple of 8. 

Figure 60. MOD Record (Card Image) 
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IDENTIFY MACRO INSTRUCTION—IDENTIFYING LOADED PROGRAM 

The IDENTIFY macro instruction# when invoked as described below# 
permits the loader to. describe a program constructed in subpool 
0 so that the program may later be invoked by a macro 
instruction such as LINK# XCTL# or ATTACH, The IDENTIFY macro 
instruction creates a contents directory entry CCDE) and an 
extent list for the program constructed. These system control 
blocks allow the supervisor to identify the program. 

The addresses and lengths of the program's extents# the entry 
point address# and the program name must be passed to the 
IDENTIFY macro instruction. (The format of the parameter list 
passed by the loader to the IDENTIFY macro instruction is shown 
in Figure 33 on page 80.) The IDENTIFY macro instruction flags 
the CDE that it creates to indicate that the program can be 
invoked by other macro instructions as well as by the LOAD macro 
instruction. Residence of the program in subpool 0 and the 
absence of the program as a load module on an external device 
are also indicated in the CDE. The IDENTIFY macro instruction 
places the CDE on the user's job pack area control queue; it 
also derives the extent list from the parameter list passed to 
it# and stores the extent list within the system queue area. 

When the form of the IDENTIFY macro instruction described below 
is specified# all other operands are ignored. The format is: 


Name 

Operation 

operand 

[symbol] 

IDENTIFY 

MF=(E#address of parameter list I(1)) 


where: 

MF= 

indicates the execute form of the macro instruction using a 
remote parameter list. (The format of the parameter list 
passed by the loader is shown in Figure 33 on page 80.) 

The address of the parameter list can be loaded into 
register 1# in which case MF=(E#(1)) should be coded. If 
the address is not loaded into register 1# it can be coded 
as an address that is valid in an RX-type instruction# or 
as one of the registers 2 through 12 that were previously 
loaded with the address. A register can be designated 
symbolically or with an absolute expression# and is always 
coded within parentheses. 

Programming Notes: Failure to meet any of the following 
requirements will cause an exit with a return code to indicate 
the reason for unsuccessful completion. The requirements are: 

1. The extent list size must be a positive multiple of 8. 

2. The addresses in the parameter list must be in subpool 0. 

3. The program name should not duplicate a name already on the 
link pack area control queue or the user's job pack area 
control queue. 

4. The entry point must be within one of the extents. 

5. The caller must be a nonsupervisory routine. 

6. The extents must be in the user's region in subpool 0# and 
they must begin on doubleword boundaries. 

When the IDENTIFY macro instruction returns control# register 15 
contains one of the following hexadecimal codes: 
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Code Meaning 

00 Successful completion. 

04 Program name and address already exist. 

08 Program name duplicates the name of a load module 

currently in virtual storage; CDE was not created. 

0C Entry point address is not within an eligible program; 

CDE was not created. 

14 An IDENTIFY macro instruction was previously issued 

using the same program name* but a different address; 
this request was ignored. 

18 Parameter list address is not on a doubleword 

boundary* or the program name specified is already on 
the link pack area control queue or the user's job 
pack area control queue; CDE was not created. 

1C Extent list length is negative* not a multiple of 8* 

or the extent addresses are not on doubleword 
boundaries; CDE was not created. 

20 Extents are not in subpool 0; CDE was not created. 
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LIST OF TERMS AND ABBREVIATIONS 


adcon 

CESD 

CSECT 

DECS 

DSECT 

EOM 

ESD ID 
K 
LD 
LR 

P pointer 

PC 

PR 

R pointer 

RLD 

SD 

TTR 

WX 


address constant 

composite external symbol dictionary 

control section 

data event control block 

dummy section 

end of module 

external symbol dictionary identification 
1024 

label definition 
label reference 
position pointer 
private code 
pseudo register 
relocation pointer 
relocation dictionary 
section definition 

relative track arid record address on a 
direct-access device 

weak external reference 
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index 


m 


A-type address constant# purpose of 36 
abbreviations and acronyms# dictionary 
of 111 

address assignment 

for common areas 42 
for external DSECTs 42 
in nonresolution 24-27 
in resolution 28-31 
address constants# relocation of 
description of 37 
introduction to 5 
address list for BLDL information 
purpose of 40-42 
routine that builds the lists 73 
allocation 

of buffers and DECBs 14-16 
of save areas 12 
of table entries 24 
automatic 

deletion (for CESD type SD) 30-31 
, library calls 40 


m 


BLDL list 

format of 73 
purpose of 40-42 

BLDL macro instruction# issuance of 40 
boundary alignment (for PR entries) 
description of 43 
introduction to 32 
buffer# allocation of 14-16 




CALL|NOCALL|NCAL option 8 
CESD entry 24, 27 

See also composite external symbol 
dictionary entry 
common (CM) area 

address assignment of 42 
definition of 21 
processing a CM entry 27 
common reference 20 
communication area (HENLDC0M) 
format of 81 
initialization of 12 
composite external symbol dictionary 
entry 

definition of 19 
internal format 77 
making an entry 24 
processing of 22-32 
record format of 100 
concatenated data sets (on SYSLIN) 3# 
13 

condensed symbol table 
creation of 44 


format of 77 
purpose of 11 
control 

and relocation dictionary record 
format 104 
dictionaries 5 
information processing 12 
record 

description 19 
format 102 
processing 34 

control level tables (routines) 62-66 
CR 

See common reference 
CSECT Identification Record 
record format 105 
treatment of 21 


data area layouts 

address list for BLDL information 73 
communication area (HENLDCQM) 81 
default and ddname CSECT 
(HEWLDDEF) 84 
INITMAIN work area 85 
data control block (DCB) for SYSLIN, 
SYSTERM# and SYSLOUT data sets, 
construction of 13 

data control block (DCB), alternate for 
SYSLIB 12, 107 

data event control block (DECB), format 
of 78 

DCB list# format of 106 

default and ddname CSECT (HEHLDDEF) 84 

deleting CSECTs 

in ESD processing 30-34 
in load module input 34# 35 
delinking 38-39 
diagnostic 
aids 88 

register contents at entry to 
routines 88 

dictionary print routine (HEWBTMAP) 
messages 92-93 
diagrams, operation 47-60 
directory, microfiche 70-72 
dummy DSECT# external 

See external dummy section 


H 

END 

processing 39 
record formats 97 
entry point determination 
checking of 44 

default for preloaded text 34 
in ESD processing 26 

EOM 

See END 

EP=(keyword) 8 
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ER 

See external reference 
error 

diagnostic dictionary processing 
routine (HEWBTMAP) 
messages 92-93 
internal code definitions 90 
message-issuer cross reference 
table 92-93 

ESD 

See external symbol dictionary 
ESD ID 

definition of 6 
in END processing 39 
in ESD processing 27-28 
in RLD processing 36-37 
in text processing 32-34 
extent 

chain entry format 79 
processing 33 

external dummy section (pseudo register) 
address assignment 42 
definition of 6 
entry processing 

displacement and boundary 
alignment 32 
PR entry 27 

symbol resolution in 32 
function of 21 
external reference (ER) 
definition of 21 
entry processing 

match processing 30* 31 
no-match processing 27 
function of 21 
unresolved ER messages 43 
unresolved ER processing 40 
external symbol dictionary (ESD) 
definition of 6 
entry types 22 
identifier 
See ESD ID 
processing 

description of 19-32 
introduction to 10 
operation diagrams for 53-55 
record format 94 

EXTRACT macro instruction* issuance 
of 12 


final processing 

description of 41 
overview 11 

functions of the loader 1 




general register contents 88-89 




HEMLDCOM (communication area) 
format of 81-84 
initialization of 12 
HEWLDDEF 

data area layout 84 
definition 3, 12 
HEWLLIBR 3* 61 

HEMLOAD* entry point for loading with 
identification 44 


CD 


I/O control-allocation* description 
of 13 

ID-length list 34 
identification of loaded program 
See also program name 
processing 43 
purpose of 11 

saving extent information for 33 
IDENTIFY macro instruction 
issuance of 11* 44 
parameter list 

creation of 44 
format of 80 
record format 105 
treatment of 33 
initialization processing 
description of 11 
operation diagram of 49 
INITMAIN work area* format of 85 
input 

conventions 93 
entry types 24 

description of 19 
introduction to 13 
primary data set 3 
record formats 94-105 
secondary data set 3 
secondary input processing 
description of 41 
internal input data area 

See also passed data sets 
concatenation restriction 4 
definition of 3 
format 

fixed-length records 107 
variable-length records 108 
processing 10* 12 
reading of 17 

SYSLIN control block for 12, 106 
internal object module 

See internal input data area 


ED 

label 

definition (LD) or reference (LR) 
LD and LR processing 
description of 26 
introduction to 23 
reference 21 

when CESD type is CM 31-32 
when CESD type is SD 30 


21 
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language translators 3 
LD 

See label definition 
LETINOLET option 8 
library calls 40, 41 

See also automatic library call 
processor and secondary input 
processin 
load module 
processing 

description of (see also reading 
load module text) 20 
operation diagram of 58 
RLD buffer, use of 18 
load module processing 
description of 17 

See also reading load module text 

Loader 

data sets 3 
options 7 
organization 61 
structure 3 




MAP option, processing of 24 

MAP|NOMAP option 8 

map, module, format example of 91 

match processing 29-32 

microfiche directory 70-72 

MOD record 

contents of 19 
input convention 94 
processing 33-34 
record format 108 


H 

NAME=(keyword) 

See program name 
no-match processing 

description of 24-33 
tabulation of 24 
null type of ESD entry 21 




object and load module processing, 
differences 18 
object module 

allocation for 17 
control dictionaries in 5 
operation diagrams 47-60 
options 7 
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passed data sets, compiler/loader 
interface 105-108 
PC 

See private code 

pointers, RLD (relocation dictionary 
processing), use of 36-37 
PR 

See pseudo register 
preloaded text 
See MOD record 
PRINT I NOPRINT option 8 
private code (PC) 21 
processing control module 

See initialization, I/O, control and 
allocation processor 
program name 

passing to control program 12 
specifying 8 
pseudo register (PR) 

address assignment 42 
definition of 6 
entry processing 

displacement and boundary 
alignment 32 
symbol resolution in 32 
function of 21 


Q—type address constant 
purpose of 37 
use of in pseudo register 
relocation 42 




reading 

load module text 34 
module input 16-17 
readying data sets 13 
register contents at entry to 
routines 88-89 
aids 

register contents at entry to 
routines 89 

relative relocation constant 
definition of 37 
use of 38 

relocating address constants 38 
relocation constant, computing 27 
relocation dictionary (RLD) 
entries, use of 19 
introduction to 6 
processing 

details of 36-37 
introduction to 10 
operation diagram 59 
processor (HEMLRLD) 

for load module 103, 104 
input record 97 
table entry format 86 
RESINORES option 8 
resolution, symbol 29-32 
RLD 
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See relocation dictionary 
RLD pointers* meaning of 6 




scatter/translation record, format 
of 101 
SD 

See section definition 
secondary input processing 
description of 41 
section definition (SD) 
introduction to 21 
processing an SD entry 26 
symbol resolution for SD entry 30 
serviceability aids 91 
SIZE=(keyword) 8 
storage allocation 

for buffers and DECBs 14-16 
for CESD entries 24 
for save areas used during 
loading 12 
SYM record 

format of input record 94 
format of record in load module 99 
treatment of 19 
symbol resolution 29-32 
SYSLIB data set 

alternate DCB for 12, 107 
characteristics of 3 
opening 40 

passing an open data set 12, 40 
resolving ERs from 40 
SYSLIN control block 

See also passed data sets 
format 106 
processing 12 

use in reading internal input 17 
SYSLIN data set 

See also internal input data area and 
passed data sets 
definition of 3 

initialization and input control 
of 12-13 


SYSLOUT data set 

initialization of 13 
purpose of 3 
SYSTERM data set 

initialization of 13 
purpose of 3 


m 


tables 

construction and usage 73 
used in the CESD search 23 
TERM|NOTERM option 8 
text 

input record format 96 
loading 33-34 
processing 18 
record processing 33-34 
text processing (operation diagram) 
translation 

of IDs in ID/length list 34 
translation control table, format of 86 
translation table 
format of 86 
making an entry in 27-28 
relation to translation control 
table 27 




V-type address constant, purpose of 37 
virtual storage allocation 24 


m 

weak external reference (MX) 
definition of 21 
processing 24 
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